Customer Subuser Event Notification URL

Manage Customer Subusers' 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 subuser
user	Yes	Customer subuser must be registered under your account	The username of the customer subuser
method	Yes	Must be set to `eventposturl`	Allows you to access post event URL functionality

Call

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

Response

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

Call

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

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 set the event notification URL for the specified customer subuser
user	Yes	Customer subuser must be registered under your account	The name of the customer subuser
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.subuserManage.json`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=set&user=example@example.com&url=http://www.SubUserPostUrlHere.com&method=eventposturl`

Response

{
  "message": "success"
}

Call

POST	`https://api.sendgrid.com/apiv2/reseller.subuserManage.xml`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=set&user=example@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 subuser
user	Yes	Customer subuser must be registered under your account	The name of the customer subuser
method	Yes	Must be set to `eventposturl`	Allows you to access post event URL functionality

Call

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

Response

{
  "message": "success"
}

Call

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

Response

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

Rate this page:

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?

Thank you for your feedback!

Thanks for your feedback!

Step 1

Step 2

Step 3