Bounces API
An email is considered bounced when the message is undeliverable and then returned to the server that sent it. Bounced emails can be either permanent or temporary failures to deliver the message.
For more information, see our Bounces documentation.
You can also manage bounced emails from the Suppression settings menu in the Twilio SendGrid App.
Delete a bounce
DELETE /suppression/bounces/{email}
This endpoint allows you to remove an email address from your bounce list.
Authentication
- API Key
Headers
Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required
on-behalf-of
string
default: The subuser's username. This header generates the API call as if the subuser account was making the call.
Request Body
null
Path Parameters
email
string
default: None
required
Query String
email_address
string
The email address you would like to remove from the bounce list.
default: Nonerequired
Responses
object
object
errors
array[object]
message
string
the error message
field
string or null
the field that generated the error
help
object
helper text or docs for troubleshooting
id
string
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}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.