Subuser Unsubscribes

(warning)

This documentation is for the SendGrid Web API v2

To access all the latest features and upcoming developments, please see our v3 API.

Retrieve Unsubscribes

URI Parameter	Required	Requirements	Description
task	Yes	Must be set to `get`	Task to retrieve unsubscribes for subuser
user	Yes	Subuser must be under your account	Subuser to retrieve unsubscribes for
date	No	0 or 1	Optional argument to retrieve the timestamps, in ISO-8601 format, Pacific Timezone: `YYYY-MM-DD HH:MM:SS`

JSONXML

Call

POST	`https://api.sendgrid.com/api/user.unsubscribes.json`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&user=subuser_username&task=get&date=1`

Response


_10[
_10  {
_10    "email": "emaieexampexample@example.com",
_10    "created": "2009-06-01 19:41:39"
_10  },
_10  {
_10    "email": "emaileexampexample@example.com",
_10    "created": "2009-06-01 19:41:39"
_10  }
_10]

Delete Unsubscribes

SendGrid suppresses messages to unsubscribed addresses, but entries can be removed from the suppression list at any time if redelivery to an unsubscribed address is desired. Take care that the address should be redelivered to.

URI Parameter	Required	Requirements	Description
task	Yes	Must be set to `delete`	Task to remove unsubscribed address from subuser
user	Yes	Subuser must be under your account	Subuser to remove unsubscribed address from
email	Yes	Address exists on the list	Address to remove from the Unsubscribe suppression list

JSONXML

Call

POST	`https://api.sendgrid.com/api/user.unsubscribes.json`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&user=subuser_username&task=delete&email=unsubscribe@sample.com`

Response


_10{
_10  "message": "success"
_10}

Add Unsubscribes

Manually add address to the Unsubscribe suppression list, to prevent delivery to the address.

URI Parameter	Required	Requirements	Description
task	Yes	Must be set to `add`	Task to add address to subuser Unsubscribe list
user	Yes	Subuser must be under your account	Subuser to add Unsubscribed address
email	Yes	Valid email address	Address to add to the Unsubscribe suppression list

JSONXML

Call

POST	`https://api.sendgrid.com/api/user.unsubscribes.json`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&user=subuser_username&task=add&email=unsubscribe@sample.com`

Response


_10{
_10  "message": "success"
_10}