To access all the latest features and upcoming developments, please see our v3 API.
| URI Parameter | Required | Requirements | Description |
|---|---|---|---|
| task | Yes | Must be set to get | Task to retrieve the invalid emails for the specified subuser |
| user | Yes | Subuser must be under your account | The subuser retrieving invalid emails from |
| date | No | 0 or 1 | Optional argument to retrieve the timestamps, in ISO-8601 format, Pacific Timezone: YYYY-MM-DD HH:MM:SS |
| POST | https://api.sendgrid.com/apiv2/customer.invalidemails.json |
|---|---|
| POST Data | api_user=your_sendgrid_username&api_key=your_sendgrid_password&user=subuser_username&task=get&date=1 |
_17[_17 {_17 "email": "example@example.com",_17 "reason": "Mail domain mentioned in email address is unknown",_17 "created": "2009-06-01 19:41:39"_17 },_17 {_17 "email": "isaac@hotmail",_17 "reason": "Bad Syntax",_17 "created": "2009-06-01 19:41:39"_17 },_17 {_17 "email": "example@example.com",_17 "reason": "Known bad domain",_17 "created": "2009-06-01 19:41:39"_17 }_17]
SendGrid drops messages to invalid emails. Users can remove invalid emails from their list at any time if they believe the address to now be valid.
| URI Parameter | Required | Requirements | Description |
|---|---|---|---|
| task | Yes | Must be set to delete | Task to remove the specified email from the invalid email list for the specified subuser |
| user | Yes | Subuser must be under your account | The subuser to retrieve invalid emails from |
| Yes | Must be a string | You must specify the invalid emails to remove |