Email

Endpoints for reviewing and removing email suppressions.

Pylon stops sending email to an address once it is suppressed, either because a message hard bounced or because someone suppressed it manually. Use these endpoints to review the suppression list and to remove an address from it.

For how email support is set up, see Email.

Endpoints

Get email suppressions

get

/email-suppressions

Returns the email addresses Pylon will not send to, most recently suppressed first. Pass email to check a single address; an empty data array means it is not suppressed.

Rate limit: 300 requests per minute

Authorizations

AuthorizationstringRequired

Authorization: Bearer

Query parameters

emailstringOptional

Only return the suppression for this email address, if one exists.

cursorstringOptional

The cursor to use for pagination.

limitinteger · int64Optional

The number of suppressions to fetch. Defaults to 100. Must be greater than 0 and less than or equal to 1000.

Responses

200Success

application/json

request_idstringRequired

The request ID for tracking.

400

The request was invalid or could not be completed.

application/json

401

The request could not be authenticated for this API.

application/json

403

The authenticated caller or organization is not allowed to access this endpoint or operation.

application/json

429

The request exceeded the applicable rate limit.

application/json

500

An unexpected internal error occurred.

application/json

get/email-suppressions

GET /email-suppressions HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "bounce_details": "text",
      "created_at": "2026-01-01T00:00:00.000Z",
      "email": "text",
      "id": "text",
      "reason": "hard_bounce"
    }
  ],
  "pagination": {
    "cursor": "text",
    "has_next_page": true
  },
  "request_id": "text"
}

Remove an email suppression

delete

/email-suppressions/{id}

Removes the suppression so Pylon resumes sending email to the address.

Rate limit: 120 requests per minute

Authorizations

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID of the email suppression to remove.

Responses

200Success

application/json

request_idstringRequired

The request ID for tracking.

400

The request was invalid or could not be completed.

application/json

401

The request could not be authenticated for this API.

application/json

403

The authenticated caller or organization is not allowed to access this endpoint or operation.

application/json

404Error

application/json

429

The request exceeded the applicable rate limit.

application/json

500

An unexpected internal error occurred.

application/json

delete/email-suppressions/{id}

DELETE /email-suppressions/{id} HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "request_id": "text"
}