Remove a suppression

Take an address off your team's suppression list so SendGrail can send to it again.

DELETE /v1/suppressions/{suppression}

Requires a Full access API key.

Path parameters

Parameter	Type	Required	Description
suppression	string	Yes	The suppression id, or the suppressed email address.

Either identifies the same record — a value containing an @ is matched against the address, anything else against the id.

Example

curl

curl -X DELETE "https://api.sendgrail.com/v1/suppressions/woz@example.com" \
  -H "Authorization: Bearer $SENDGRAIL_API_KEY"

Node.js

await fetch('https://api.sendgrail.com/v1/suppressions/woz@example.com', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.SENDGRAIL_API_KEY}` },
});

Response

{
  "object": "suppression",
  "id": "a2f5c1d0-7b3e-4c9a-8f21-6d0e5b4c3a10",
  "deleted": true
}

Only a manual suppression can be removed

A bounce or complaint suppression is permanent. Trying to remove one is rejected with 409:

{
  "message": "A bounce suppression is permanent and cannot be removed.",
  "code": "suppression_permanent",
  "request_id": "8f2c1e64-1b17-4f8c-9f0e-3b6c1e0f5c31"
}

This is a deliberate guard, not a limitation. An address lands on the list with origin: "bounce" because a real send to it hard-bounced, or with origin: "complaint" because a real recipient marked your mail as spam. Sending to it again would earn the same result — and repeated bounces and spam reports are exactly what mailbox providers watch to decide whether your whole account is worth delivering. So SendGrail keeps those addresses suppressed for good, and only lets you remove the ones you added by hand.

Some providers let you delete any suppression; SendGrail does not, because doing so trades your deliverability for a convenience you rarely want. If a bounce was a genuine false positive — a mailbox that was down, an address you're certain is valid — contact support rather than looking for a way to un-suppress it silently.

To remove many manual suppressions in one call, see Remove suppressions.