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; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.

This documentation is for the SendGrid Web API v2

Need some help?