Event Notification URL

Retrieve

Parameter Required Requirements Description
task Yes Must be set to get This will allow you to retrieve the event notification url for the specified customer
user Yes Customer must be registered under your account The username of the customer
method Yes Must be set to eventposturl Allows you to access post event url functionality

XML Call

1

https://sendgrid.com/api/distributor.manage.xml?api_user=username&api_key=secureSecret&task=get&user=customer@example.com&method=eventpostur

Response

1

<url>http://www.SubUserPostUrlHere.com</url

JSON Call

1

https://sendgrid.com/api/distributor.manage.json?api_user=username&api_key=secureSecret&task=get&user=customer@example.com&method=eventpostur

Response

1

{"url":"http:\/\/www.SubUserPostUrlHere.com"}

Update / Set URL

Parameter Required Requirements Description
task Yes Must be set to set This will allow you to retrieve the event notification url for the specified customer
user Yes Customer must be registered under your account The name of the customer
url Yes The notification URL This is the new event notification URL
method Yes Must be set to eventposturl Allows you to access post event url functionality

XML Call

1

https://sendgrid.com/api/distributor.manage.xml?api_user=username&api_key=secureSecret&task=set&user=customer@example.com&url=http://www.SubUserPostUrlHere.com&method=eventpostur

Response

1
2
3
4
5

<?xml version="1.0" encoding="ISO-8859-1"?>

<result>
   <message>success</message>
</result>

JSON Call

1

https://sendgrid.com/api/distributor.manage.json?api_user=username&api_key=secureSecret&task=set&user=customer@example.com&url=http://www.SubUserPostUrlHere.com&method=eventpostur

Response

1
2
3

{
  "message": "success"
}

Delete

Parameter Required Requirements Description
task Yes Must be set to delete This will allow you to delete the event notification url for the specified customer
user Yes Customer must be registered under your account The name of the customer
method Yes Must be set to eventposturl Allows you to access post event url functionality

XML Call

1

https://sendgrid.com/api/distributor.manage.xml?api_user=username&api_key=secureSecret&task=delete&user=customer@example.com&method=eventpostur

Response

1
2
3
4
5

<?xml version="1.0" encoding="ISO-8859-1"?>

<result>
   <message>success</message>
</result>

JSON Call

1

https://sendgrid.com/api/distributor.manage.json?api_user=username&api_key=secureSecret&task=delete&user=customer@example.com&method=eventpostur

Response

1
2
3

{
  "message": "success"
}