Bounces

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.

Operations

Import list of bounces

Request

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. address is a valid email address. code is error code (optional, default: 550). error is error description (optional, default: empty string). created_at is timestamp of bounce event in RFC2822 format (optional, default: current time)

Security

basicAuth

Path

domain_namestringrequired

Domain to update bounces for

Headers

Content-Typestringrequired

Content-Type must be multipart/form-data

Bodymultipart/form-datarequired

filestringrequired

CSV file

curl -i -X POST \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v3/{domain_name}/bounces/import' \
  -H 'Content-Type: multipart/form-data' \
  -F file=string

Responses

A 202 response

Bodyapplication/json

messagestringrequired

Response message

Response

{
  "message": "file uploaded successfully for processing. standby..."
}