Create suppression

Add an email address to the suppression list. Suppressed addresses will not receive any emails from your account.

This endpoint requires admin-level access.

Rate limit: 10 requests per minute per account.

post

Authorizations

Api-TokenstringRequired

API token in Api-Token header

Body

emailstring · emailRequired

Email address to suppress

Example: [e-mail]

domain_idintegerRequired

ID of the domain to suppress this email for

Example: 12345

sending_streamstring · enumRequired

The sending stream to suppress this email for

Example: transactionalPossible values:

typestring · enumOptional

Reason for the suppression. Defaults to "manual import" if omitted.

Default: manual importExample: manual importPossible values:

Responses

201

Suppression created

application/json

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

422

Validation errors

application/json

429

Rate limit exceeded for the current account.

application/json

post/api/suppressions

curl -X POST https://mailtrap.io/api/suppressions \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "[e-mail]",
    "domain_id": 12345,
    "sending_stream": "transactional",
    "type": "manual import"
  }'

{
  "data": {
    "id": "64d71bf3-1276-417b-86e1-8e66f138acfe",
    "type": "hard bounce",
    "created_at": "2025-01-15T10:30:00Z",
    "email": "[e-mail]",
    "sending_stream": "transactional",
    "domain_name": "example.com",
    "message_bounce_category": null,
    "message_category": null,
    "message_client_ip": null,
    "message_created_at": null,
    "message_esp_response": null,
    "message_esp_server_type": null,
    "message_outgoing_ip": null,
    "message_recipient_mx_name": null,
    "message_sender_email": null,
    "message_subject": null
  }
}