Suppression

Download schema

List all suppressions for the team

GET

https://api.lettermint.co/v1

/suppressions

Bearer

List all suppressions for the team › query Parameters

page[size]

integer

The number of results that will be returned per page.

Default: 30

page[cursor]

string

The cursor to start the pagination from.

sort

string[]

Enum values:

value

-value

created_at

-created_at

reason

-reason

Default: ["-created_at"]

filter[scope]

string

Filter by scope (team, project, route)

filter[route_id]

string

Filter by route ID

filter[project_id]

string

Filter by project ID

filter[value]

string

Search by email/domain value (partial match)

filter[reason]

SuppressionReason · enum

Enum values:

spam_complaint

hard_bounce

unsubscribe

manual

filter[startDate]

string

Filter suppressions created or updated on or after this ISO 8601 date or datetime

filter[endDate]

string

Filter suppressions created or updated on or before this ISO 8601 date or datetime

List all suppressions for the team › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

List all suppressions for the team › Responses

Paginated set of SuppressedRecipientData

SuppressedRecipientData[] · required

path

string | null · required

Base path for paginator generated URLs.

per_page

integer · min: 0 · required

Number of items shown per page.

next_cursor

string | null · required

The "cursor" that points to the next set of items.

next_page_url

string | null · uri · required

prev_cursor

string | null · required

The "cursor" that points to the previous set of items.

prev_page_url

string | null · uri · required

Add email(s) to suppression list

POST

https://api.lettermint.co/v1

/suppressions

Bearer

Add email(s) to suppression list › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Add email(s) to suppression list › Request Body

StoreSuppressionData

reason

SuppressionReason · enum · required

Enum values:

spam_complaint

hard_bounce

unsubscribe

manual

scope

SuppressionScope · enum · required

Enum values:

global

team

project

route

email

string | null · email · maxLength: 255

emails

array | null · minItems: 1 · maxItems: 1000

route_id

string | null · uuid

project_id

string | null · uuid

Add email(s) to suppression list › Responses

required

object · required

POST/suppressions

curl https://api.lettermint.co/v1/suppressions \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "email": "test@example.com",
  "emails": [
    "test@example.com"
  ],
  "reason": "spam_complaint",
  "scope": "global",
  "route_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000"
}'

Example Request Body

{
  "email": "test@example.com",
  "emails": [
    "test@example.com"
  ],
  "reason": "spam_complaint",
  "scope": "global",
  "route_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000"
}

json

Example Responses

{
  "message": "string",
  "data": {
    "created": [
      "string"
    ],
    "skipped": [
      "string"
    ]
  }
}

json

application/json

Remove email from suppression list

DELETE

https://api.lettermint.co/v1

/suppressions/{suppressionId}

Bearer

Remove email from suppression list › path Parameters

suppressionId

string · required

Remove email from suppression list › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Remove email from suppression list › Responses

Suppression removed

success

boolean · required

status

string · const · required

Const value: removed

message

string · required

confidence

number

Message

List all suppressions for the team

GET

https://api.lettermint.co/v1

/suppressions

Bearer

List all suppressions for the team › query Parameters

page[size]

integer

The number of results that will be returned per page.

Default: 30

page[cursor]

string

The cursor to start the pagination from.

sort

string[]

Enum values:

value

-value

created_at

-created_at

reason

-reason

Default: ["-created_at"]

filter[scope]

string

Filter by scope (team, project, route)

filter[route_id]

string

Filter by route ID

filter[project_id]

string

Filter by project ID

filter[value]

string

Search by email/domain value (partial match)

filter[reason]

SuppressionReason · enum

Enum values:

spam_complaint

hard_bounce

unsubscribe

manual

filter[startDate]

string

Filter suppressions created or updated on or after this ISO 8601 date or datetime

filter[endDate]

string

Filter suppressions created or updated on or before this ISO 8601 date or datetime

List all suppressions for the team › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

List all suppressions for the team › Responses

Paginated set of SuppressedRecipientData

SuppressedRecipientData[] · required

path

string | null · required

Base path for paginator generated URLs.

per_page

integer · min: 0 · required

Number of items shown per page.

next_cursor

string | null · required

The "cursor" that points to the next set of items.

next_page_url

string | null · uri · required

prev_cursor

string | null · required

The "cursor" that points to the previous set of items.

prev_page_url

string | null · uri · required

Add email(s) to suppression list

POST

https://api.lettermint.co/v1

/suppressions

Bearer

Add email(s) to suppression list › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Add email(s) to suppression list › Request Body

StoreSuppressionData

reason

SuppressionReason · enum · required

Enum values:

spam_complaint

hard_bounce

unsubscribe

manual

scope

SuppressionScope · enum · required

Enum values:

global

team

project

route

email

string | null · email · maxLength: 255

emails

array | null · minItems: 1 · maxItems: 1000

route_id

string | null · uuid

project_id

string | null · uuid

Add email(s) to suppression list › Responses

required

object · required

Remove email from suppression list

DELETE

https://api.lettermint.co/v1

/suppressions/{suppressionId}

Bearer

Remove email from suppression list › path Parameters

suppressionId

string · required

Remove email from suppression list › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Remove email from suppression list › Responses

Suppression removed

success

boolean · required

status

string · const · required

Const value: removed

message

string · required

confidence

number