Event Notification URL

Manage your customers' event notification URLs.

Retrieve

URI 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

These are Reseller only APIs. For more information, see Reseller Overview.

Call

POST	`https://api.sendgrid.com/apiv2/reseller.manage.json`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=get&user=eexampexample@example.com&method=eventpostur`

Response

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

Call

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

Response

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

Update / Set URL

URI 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

Call

POST	`https://api.sendgrid.com/apiv2/reseller.manage.json`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=set&user=eexampexample@example.com&url=http://www.SubUserPostUrlHere.com&method=eventposturl`

Response

{
  "message": "success"
}

Call

POST	`https://api.sendgrid.com/apiv2/reseller.manage.xml`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=set&user=eexampexample@example.com&url=http://www.SubUserPostUrlHere.com&method=eventposturl`

Response

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

Delete

URI 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

Call

POST	`https://api.sendgrid.com/apiv2/reseller.manage.json`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=delete&user=eexampexample@example.com&method=eventposturl`

Response

{
  "message": "success"
}

Call

POST	`https://api.sendgrid.com/apiv2/reseller.manage.xml`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=delete&user=eexampexample@example.com&method=eventposturl`

Response

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

Need some help?

We all do sometimes. Get help now from the Twilio SendGrid Support Team.

Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.

This documentation is for the SendGrid Web API v2

Need some help?

Thank you for your feedback!

Thanks for your feedback!