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

POST https://api.sendgrid.com/api/distributor.manage.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=get&user=customer@example.com&method=eventpostur

Response

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

JSON Call

POST https://api.sendgrid.com/api/distributor.manage.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&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

POST https://api.sendgrid.com/api/distributor.manage.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&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

POST https://api.sendgrid.com/api/distributor.manage.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&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

POST https://api.sendgrid.com/api/distributor.manage.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&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

POST https://api.sendgrid.com/api/distributor.manage.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=delete&user=customer@example.com&method=eventpostur

Response

1
2
3
{
  "message": "success"
}