Postmark
Postmark API

Suppressions

Inspect and manage the list of addresses suppressed on a message stream.


Create a Suppression

POST
https://api.postmarkapp.com
/message-streams/{streamId}/suppressions

Suppresses up to 50 addresses on a stream. Each address gets its own result in the response, so check every entry's Status; the HTTP status is 200 even when some addresses fail.

Create a Suppression › path Parameters

streamId
​string · required

ID of the message stream (e.g. outbound, broadcast, inbound).

Create a Suppression › Request Body

Addresses to suppress on the stream.
​object[] · minItems: 1 · maxItems: 50 · required

Addresses to process. Max 50 per request.

Example: [{"EmailAddress":"address@example.com"}]

Create a Suppression › Responses

Per-address results.

Per-address results of a suppression request.
​object[] · required

One result per submitted address.

Example: [{"EmailAddress":"good.address@example.com","Status":"Suppressed","Message":"string"}]

Delete a Suppression

POST
https://api.postmarkapp.com
/message-streams/{streamId}/suppressions/delete

Removes up to 50 addresses from the suppression list of a stream. Each address gets its own result; check every entry's Status.

Delete a Suppression › path Parameters

streamId
​string · required

ID of the message stream (e.g. outbound, broadcast, inbound).

Delete a Suppression › Request Body

Addresses to remove from the suppression list.
​object[] · minItems: 1 · maxItems: 50 · required

Addresses to process. Max 50 per request. Field of DeleteSuppressionsRequest.

Example: [{"EmailAddress":"address@example.com"}]

Delete a Suppression › Responses

Per-address results. See deleteSuppressions.

Per-address results of a suppression removal. Addresses suppressed by hard bounce or spam complaint can only be removed by Postmark-managed rules; those return `Failed`.
​object[] · required

One result per submitted address. Field of DeleteSuppressionsResponse.

Example: [{"EmailAddress":"good.address@example.com","Status":"Deleted","Message":"string"}]

Suppression dump

GET
https://api.postmarkapp.com
/message-streams/{streamId}/suppressions/dump

Returns the suppression list of a message stream, optionally filtered. Suppressed addresses are not sent to on that stream.

Suppression dump › path Parameters

streamId
​string · required

ID of the message stream (e.g. outbound, broadcast, inbound).

Suppression dump › query Parameters

SuppressionReason
​SuppressionReason · enum

Filter by suppression reason.

Why the address is suppressed.

Enum values:
HardBounce
SpamComplaint
ManualSuppression
Example: HardBounce
Origin
​SuppressionOrigin · enum

Filter by who caused the suppression.

Who caused the suppression.

Enum values:
Recipient
Customer
Admin
Example: Recipient
fromdate
​string · date

Only suppressions created on or after this date, YYYY-MM-DD.

todate
​string · date

Only suppressions created on or before this date, YYYY-MM-DD.

EmailAddress
​string

Filter by email address. See getSuppressionDump.

Suppression dump › Responses

The suppressions.

Suppression list for a message stream.
​object[] · required

Suppressed addresses on the stream.

Example: [{"EmailAddress":"address@example.com","SuppressionReason":"HardBounce","Origin":"Recipient","CreatedAt":"2026-10-06T09:15:30-04:00"}]