Delete a suppression
DELETE
/v1/email/suppressions/{suppression_id}
bird email suppressions remove <suppression-id> --yescurl -X DELETE "https://us1.platform.bird.com/v1/email/suppressions/{suppression_id}" \
-H "Authorization: Bearer $TOKEN"Permanently deletes the suppression record and resumes delivery to the address. Deletion cannot be undone. If the address hard-bounces or the recipient complains again, a new suppression is created automatically.
Most records exist because the address bounced or complained, so removing one without cause resumes sending to an address that rejected mail and harms sender reputation. An address suppressed for several reasons has one record per reason. Delete each blocking record to re-enable delivery. To find a record by address, use GET /v1/email/suppressions with the email parameter. An ID that does not exist in the workspace returns 404.
A record with reason complaint can only be deleted by a signed-in dashboard user; an API key gets 422 (SuppressionNotRemovableByAPIKey). hard_bounce and manual records are unaffected and stay removable either way.
Parameter
suppression_id
string
ID of the suppression record, as returned when the suppression was created or listed.