Bounces - Bounce list stores events of delivery failures due to permanent recipient mailbox errors such as non-existent mailbox. Soft bounces (for example, mailbox is full) and other failures (for example, ESP rejects an email because it thinks it is spam) are not added to the list.
Import a CSV file containing a list of addresses to add to the bounce list. The CSV file must be 25MB or under and must contain the following column headers: address, code, error, created_at
A 202 response
A 400 response
A 500 response
{- "message": "file uploaded successfully"
}
Fetch a single bounce event by a given email address.
{- "address": "foo@bar.com",
- "error": "No such mailbox",
- "code": "550",
- "created_at": "Mon, 06 May 2024 18:11:58 UTC"
}
The delivery to the deleted email address resumes until it bounces again.
{- "message": "Bounced addresses for this domain have been removed",
- "address": "foo@bar.com"
}
Paginate over a list of bounces for a domain.
A 200 response
required | Array of objects |
required | object |
A 400 response
{- "items": [
- {
- "address": "foo@bar.com",
- "code": "550",
- "created_at": "Mon, 06 May 2024 18:11:58 UTC",
- "error": "No such mailbox"
}
], - "paging": {
- "last": "<last page url>",
- "previous": "<previous page url>",
- "first": "<first page url>",
- "next": "<next page url>"
}
}
Request body is expected to be a valid JSON encoded sting containing up to 1000 bounce records or a single bounce record as application/form-data
{- "message": "4 addresses have been added to the bounces table"
}
Clears all email addresses with bounces from the domain. Delivery to the deleted email addresses will longer be suppressed.
{- "message": "Bounced addresses for this domain have been removed"
}