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 subuser
user Yes Subuser must be registered under your account The username of the subuser

Call

POST https://api.sendgrid.com/apiv2/customer.eventposturl.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=get&user=example@example.com

Response

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

Call

POST https://api.sendgrid.com/apiv2/customer.eventposturl.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=get&user=example@example.com

Response

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

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

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 subuser
user Yes Subuser must be registered under your account The name of the subuser
url Yes The notification URL This is the new event notification URL

Call

POST https://api.sendgrid.com/apiv2/customer.eventposturl.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=set&user=example@example.com&url=http://www.SubUserPostUrlHere.co

Response

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

Call

POST https://api.sendgrid.com/apiv2/customer.eventposturl.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=set&user=example@example.com&url=http://www.SubUserPostUrlHere.co

Response

1
2
3
4
5
<?xml version="1.0" encoding="ISO-8859-1"?>

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

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 subuser
user Yes Subuser must be registered under your account The name of the subuser

Call

POST https://api.sendgrid.com/apiv2/customer.eventposturl.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=delete&user=example@example.co

Response

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

Call

POST https://api.sendgrid.com/apiv2/customer.eventposturl.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=delete&user=example@example.co

Response

1
2
3
4
5
<?xml version="1.0" encoding="ISO-8859-1"?>

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