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

XML Call

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

Response

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

JSON Call

POST https://api.sendgrid.com/api/distributor.manageSubuser.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&task=get&user=example@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 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

XML Call

POST https://api.sendgrid.com/api/distributor.manageSubuser.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=eventpostur

Response

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

JSON Call

POST https://api.sendgrid.com/api/distributor.manageSubuser.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=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 subuser
user Yes Customer subuser must be registered under your account The name of the customer subuser

XML Call

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

Response

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

JSON Call

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

Response

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