Event Notification URL

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

1

https://sendgrid.com/api/user.eventposturl.xml?api_user=username&api_key=secureSecret&task=get&user=example@example.com

Response

1
2
3

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

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

Call

1

https://sendgrid.com/api/user.eventposturl.json?api_user=username&api_key=secureSecret&task=get&user=example@example.com

Response

1
2
3

{
  "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 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

1

https://sendgrid.com/api/user.eventposturl.xml?api_user=username&api_key=secureSecret&task=set&user=example@example.com&url=http://www.SubUserPostUrlHere.com

Response

1
2
3
4
5

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

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

Call

1

https://sendgrid.com/api/user.eventposturl.json?api_user=username&api_key=secureSecret&task=set&user=example@example.com&url=http://www.SubUserPostUrlHere.com

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

Call

1

https://sendgrid.com/api/user.eventposturl.xml?api_user=username&api_key=secureSecret&task=delete&user=example@example.com

Response

1
2
3
4
5

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

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

Call

1

https://sendgrid.com/api/user.eventposturl.json?api_user=username&api_key=secureSecret&task=delete&user=example@example.com

Response

1
2
3

{
  "message": "success"
}