Project

Endpointhttps://api.lettermint.co/v1

List all projects for the team

GET

https://api.lettermint.co/v1

/projects

List all projects for the team › query Parameters

sort

string

Available sorts are name, created_at. You can sort by multiple options by separating them with a comma. To sort in descending order, use - sign in front of the sort, for example: -name.

Default: -created_at

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.

filter[search]

string

List all projects for the team › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

List all projects for the team › Responses

200

Paginated set of ProjectListData

object[] · 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

GET/projects

curl --request GET \
  --url https://api.lettermint.co/v1/projects \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "data": [
    {
      "id": "id",
      "name": "name",
      "smtp_enabled": true,
      "routes_count": 0,
      "domains_count": 0,
      "team_members_count": 0,
      "last_28_days": {
        "messages_transactional": 0,
        "messages_broadcast": 0,
        "messages_inbound": 0,
        "deliverability": 0
      },
      "created_at": "created_at",
      "updated_at": "updated_at"
    }
  ],
  "path": "path",
  "per_page": 0,
  "next_cursor": "next_cursor",
  "next_page_url": "https://www.example.com/path/to/resource",
  "prev_cursor": "prev_cursor",
  "prev_page_url": "https://www.example.com/path/to/resource"
}

json

application/json

Create a new project

POST

https://api.lettermint.co/v1

/projects

Create a new project › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Create a new project › Request Body

name

string · maxLength: 255 · required

smtp_enabled

boolean

Default: false

initial_routes

string · enum

Enum values:

both

transactional

broadcast

Default: both

Create a new project › Responses

object · required

message

string · const · required

Const value: Project created successfully.

api_token

string · required

POST/projects

curl --request POST \
  --url https://api.lettermint.co/v1/projects \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "smtp_enabled": false,
  "initial_routes": "both"
}
'

shell

Example Request Body

{
  "name": "name",
  "smtp_enabled": false,
  "initial_routes": "both"
}

json

Example Responses

{
  "data": {
    "id": "id",
    "name": "name",
    "smtp_enabled": true,
    "default_route_id": "default_route_id",
    "token_generated_at": "2024-08-25T15:00:00Z",
    "token_last_used_at": "2024-08-25T15:00:00Z",
    "token_last_used_ip": "token_last_used_ip",
    "routes": [
      {
        "id": "id",
        "project_id": "project_id",
        "slug": "slug",
        "name": "name",
        "route_type": "transactional",
        "is_default": true,
        "inbound_address": "inbound_address",
        "inbound_domain": "inbound_domain",
        "inbound_domain_verified_at": "2024-08-25T15:00:00Z",
        "inbound_spam_threshold": 0,
        "attachment_delivery": "attachment_delivery",
        "webhooks_count": 0,
        "suppressed_recipients_count": 0,
        "statistics": {},
        "created_at": "2024-08-25T15:00:00Z",
        "updated_at": "2024-08-25T15:00:00Z"
      }
    ],
    "routes_count": 0,
    "domains": [
      {
        "id": "id",
        "domain": "domain",
        "status_changed_at": "2024-08-25T15:00:00Z",
        "dns_records": [
          {
            "id": "id",
            "type": "TXT",
            "hostname": "hostname",
            "fqdn": "fqdn",
            "content": "content",
            "status": "active",
            "verified_at": "verified_at",
            "last_checked_at": "2024-08-25T15:00:00Z"
          }
        ],
        "projects": [
          {
            "id": "id",
            "name": "name"
          }
        ],
        "created_at": "2024-08-25T15:00:00Z"
      }
    ],
    "domains_count": 0,
    "team_members": [
      {
        "id": "id",
        "user": {
          "id": "id",
          "name": "name",
          "email": "email",
          "avatar": "avatar"
        },
        "role": "role",
        "joined_at": "2024-08-25T15:00:00Z"
      }
    ],
    "team_members_count": 0,
    "last_28_days": {
      "messages_transactional": 0,
      "messages_broadcast": 0,
      "messages_inbound": 0,
      "deliverability": 0
    },
    "created_at": "created_at",
    "updated_at": "updated_at"
  },
  "message": "Project created successfully.",
  "api_token": "api_token"
}

json

application/json

Get project details

GET

https://api.lettermint.co/v1

/projects/{projectId}

Get project details › path Parameters

projectId

string · required

Get project details › query Parameters

include

string

Available includes are routes, routesCount, routesExists, domains, domainsCount, domainsExists, teamMembers, teamMembersCount, teamMembersExists, messageStats, messageStatsCount, messageStatsExists. You can include multiple options by separating them with a comma.

Get project details › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Get project details › Responses

200

ProjectData

id

string · required

name

string · required

smtp_enabled

boolean · required

default_route_id

string | null · required

token_generated_at

string | null · date-time · required

token_last_used_at

string | null · date-time · required

token_last_used_ip

string | null · required

created_at

string · required

updated_at

string · required

object[]

routes_count

integer

object[]

domains_count

integer

object[]

team_members_count

integer

GET/projects/{projectId}

curl --request GET \
  --url https://api.lettermint.co/v1/projects/:projectId \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "id": "id",
  "name": "name",
  "smtp_enabled": true,
  "default_route_id": "default_route_id",
  "token_generated_at": "2024-08-25T15:00:00Z",
  "token_last_used_at": "2024-08-25T15:00:00Z",
  "token_last_used_ip": "token_last_used_ip",
  "routes": [
    {
      "id": "id",
      "project_id": "project_id",
      "slug": "slug",
      "name": "name",
      "route_type": "transactional",
      "is_default": true,
      "inbound_address": "inbound_address",
      "inbound_domain": "inbound_domain",
      "inbound_domain_verified_at": "2024-08-25T15:00:00Z",
      "inbound_spam_threshold": 0,
      "attachment_delivery": "attachment_delivery",
      "webhooks_count": 0,
      "suppressed_recipients_count": 0,
      "statistics": {},
      "created_at": "2024-08-25T15:00:00Z",
      "updated_at": "2024-08-25T15:00:00Z"
    }
  ],
  "routes_count": 0,
  "domains": [
    {
      "id": "id",
      "domain": "domain",
      "status_changed_at": "2024-08-25T15:00:00Z",
      "dns_records": [
        {
          "id": "id",
          "type": "TXT",
          "hostname": "hostname",
          "fqdn": "fqdn",
          "content": "content",
          "status": "active",
          "verified_at": "verified_at",
          "last_checked_at": "2024-08-25T15:00:00Z"
        }
      ],
      "projects": [
        {
          "id": "id",
          "name": "name"
        }
      ],
      "created_at": "2024-08-25T15:00:00Z"
    }
  ],
  "domains_count": 0,
  "team_members": [
    {
      "id": "id",
      "user": {
        "id": "id",
        "name": "name",
        "email": "email",
        "avatar": "avatar"
      },
      "role": "role",
      "joined_at": "2024-08-25T15:00:00Z"
    }
  ],
  "team_members_count": 0,
  "last_28_days": {
    "messages_transactional": 0,
    "messages_broadcast": 0,
    "messages_inbound": 0,
    "deliverability": 0
  },
  "created_at": "created_at",
  "updated_at": "updated_at"
}

json

application/json

Update project settings

PUT

https://api.lettermint.co/v1

/projects/{projectId}

Update project settings › path Parameters

projectId

string · required

Update project settings › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Update project settings › Request Body

name

string | null · maxLength: 255

smtp_enabled

boolean | null

default_route_id

string | null · uuid

Update project settings › Responses

object · required

message

string · const · required

Const value: Project updated successfully.

PUT/projects/{projectId}

curl --request PUT \
  --url https://api.lettermint.co/v1/projects/:projectId \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "smtp_enabled": true,
  "default_route_id": "00000000-0000-0000-0000-000000000000"
}
'

shell

Example Request Body

{
  "name": "name",
  "smtp_enabled": true,
  "default_route_id": "00000000-0000-0000-0000-000000000000"
}

json

Example Responses

{
  "data": {
    "id": "id",
    "name": "name",
    "smtp_enabled": true,
    "default_route_id": "default_route_id",
    "token_generated_at": "2024-08-25T15:00:00Z",
    "token_last_used_at": "2024-08-25T15:00:00Z",
    "token_last_used_ip": "token_last_used_ip",
    "routes": [
      {
        "id": "id",
        "project_id": "project_id",
        "slug": "slug",
        "name": "name",
        "route_type": "transactional",
        "is_default": true,
        "inbound_address": "inbound_address",
        "inbound_domain": "inbound_domain",
        "inbound_domain_verified_at": "2024-08-25T15:00:00Z",
        "inbound_spam_threshold": 0,
        "attachment_delivery": "attachment_delivery",
        "webhooks_count": 0,
        "suppressed_recipients_count": 0,
        "statistics": {},
        "created_at": "2024-08-25T15:00:00Z",
        "updated_at": "2024-08-25T15:00:00Z"
      }
    ],
    "routes_count": 0,
    "domains": [
      {
        "id": "id",
        "domain": "domain",
        "status_changed_at": "2024-08-25T15:00:00Z",
        "dns_records": [
          {
            "id": "id",
            "type": "TXT",
            "hostname": "hostname",
            "fqdn": "fqdn",
            "content": "content",
            "status": "active",
            "verified_at": "verified_at",
            "last_checked_at": "2024-08-25T15:00:00Z"
          }
        ],
        "projects": [
          {
            "id": "id",
            "name": "name"
          }
        ],
        "created_at": "2024-08-25T15:00:00Z"
      }
    ],
    "domains_count": 0,
    "team_members": [
      {
        "id": "id",
        "user": {
          "id": "id",
          "name": "name",
          "email": "email",
          "avatar": "avatar"
        },
        "role": "role",
        "joined_at": "2024-08-25T15:00:00Z"
      }
    ],
    "team_members_count": 0,
    "last_28_days": {
      "messages_transactional": 0,
      "messages_broadcast": 0,
      "messages_inbound": 0,
      "deliverability": 0
    },
    "created_at": "created_at",
    "updated_at": "updated_at"
  },
  "message": "Project updated successfully."
}

json

application/json

Delete a project

DELETE

https://api.lettermint.co/v1

/projects/{projectId}

Delete a project › path Parameters

projectId

string · required

Delete a project › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Delete a project › Responses

200

message

string · const · required

Const value: Project deleted successfully.

Rotate project API token

POST

https://api.lettermint.co/v1

/projects/{projectId}/rotate-token

Rotate project API token › path Parameters

projectId

string · required

Rotate project API token › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Rotate project API token › Responses

200

object · required

new_token

string · required

message

string · const · required

Const value: API token rotated successfully. Please update your integrations.

POST/projects/{projectId}/rotate-token

curl --request POST \
  --url https://api.lettermint.co/v1/projects/:projectId/rotate-token \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "data": {
    "id": "id",
    "name": "name",
    "smtp_enabled": true,
    "default_route_id": "default_route_id",
    "token_generated_at": "2024-08-25T15:00:00Z",
    "token_last_used_at": "2024-08-25T15:00:00Z",
    "token_last_used_ip": "token_last_used_ip",
    "routes": [
      {
        "id": "id",
        "project_id": "project_id",
        "slug": "slug",
        "name": "name",
        "route_type": "transactional",
        "is_default": true,
        "inbound_address": "inbound_address",
        "inbound_domain": "inbound_domain",
        "inbound_domain_verified_at": "2024-08-25T15:00:00Z",
        "inbound_spam_threshold": 0,
        "attachment_delivery": "attachment_delivery",
        "webhooks_count": 0,
        "suppressed_recipients_count": 0,
        "statistics": {},
        "created_at": "2024-08-25T15:00:00Z",
        "updated_at": "2024-08-25T15:00:00Z"
      }
    ],
    "routes_count": 0,
    "domains": [
      {
        "id": "id",
        "domain": "domain",
        "status_changed_at": "2024-08-25T15:00:00Z",
        "dns_records": [
          {
            "id": "id",
            "type": "TXT",
            "hostname": "hostname",
            "fqdn": "fqdn",
            "content": "content",
            "status": "active",
            "verified_at": "verified_at",
            "last_checked_at": "2024-08-25T15:00:00Z"
          }
        ],
        "projects": [
          {
            "id": "id",
            "name": "name"
          }
        ],
        "created_at": "2024-08-25T15:00:00Z"
      }
    ],
    "domains_count": 0,
    "team_members": [
      {
        "id": "id",
        "user": {
          "id": "id",
          "name": "name",
          "email": "email",
          "avatar": "avatar"
        },
        "role": "role",
        "joined_at": "2024-08-25T15:00:00Z"
      }
    ],
    "team_members_count": 0,
    "last_28_days": {
      "messages_transactional": 0,
      "messages_broadcast": 0,
      "messages_inbound": 0,
      "deliverability": 0
    },
    "created_at": "created_at",
    "updated_at": "updated_at"
  },
  "new_token": "new_token",
  "message": "API token rotated successfully. Please update your integrations."
}

json

application/json

Update project members

PUT

https://api.lettermint.co/v1

/projects/{projectId}/members

Update project members › path Parameters

projectId

string · required

Update project members › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Update project members › Request Body

team_member_ids

string[] · required

Update project members › Responses

object · required

message

string · const · required

Const value: Project members updated successfully.

PUT/projects/{projectId}/members

curl --request PUT \
  --url https://api.lettermint.co/v1/projects/:projectId/members \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "team_member_ids": [
    "00000000-0000-0000-0000-000000000000"
  ]
}
'

shell

Example Request Body

{
  "team_member_ids": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

json

Example Responses

{
  "data": {
    "id": "id",
    "name": "name",
    "smtp_enabled": true,
    "default_route_id": "default_route_id",
    "token_generated_at": "2024-08-25T15:00:00Z",
    "token_last_used_at": "2024-08-25T15:00:00Z",
    "token_last_used_ip": "token_last_used_ip",
    "routes": [
      {
        "id": "id",
        "project_id": "project_id",
        "slug": "slug",
        "name": "name",
        "route_type": "transactional",
        "is_default": true,
        "inbound_address": "inbound_address",
        "inbound_domain": "inbound_domain",
        "inbound_domain_verified_at": "2024-08-25T15:00:00Z",
        "inbound_spam_threshold": 0,
        "attachment_delivery": "attachment_delivery",
        "webhooks_count": 0,
        "suppressed_recipients_count": 0,
        "statistics": {},
        "created_at": "2024-08-25T15:00:00Z",
        "updated_at": "2024-08-25T15:00:00Z"
      }
    ],
    "routes_count": 0,
    "domains": [
      {
        "id": "id",
        "domain": "domain",
        "status_changed_at": "2024-08-25T15:00:00Z",
        "dns_records": [
          {
            "id": "id",
            "type": "TXT",
            "hostname": "hostname",
            "fqdn": "fqdn",
            "content": "content",
            "status": "active",
            "verified_at": "verified_at",
            "last_checked_at": "2024-08-25T15:00:00Z"
          }
        ],
        "projects": [
          {
            "id": "id",
            "name": "name"
          }
        ],
        "created_at": "2024-08-25T15:00:00Z"
      }
    ],
    "domains_count": 0,
    "team_members": [
      {
        "id": "id",
        "user": {
          "id": "id",
          "name": "name",
          "email": "email",
          "avatar": "avatar"
        },
        "role": "role",
        "joined_at": "2024-08-25T15:00:00Z"
      }
    ],
    "team_members_count": 0,
    "last_28_days": {
      "messages_transactional": 0,
      "messages_broadcast": 0,
      "messages_inbound": 0,
      "deliverability": 0
    },
    "created_at": "created_at",
    "updated_at": "updated_at"
  },
  "message": "Project members updated successfully."
}

json

application/json

Add a member to the project

POST

https://api.lettermint.co/v1

/projects/{projectId}/members/{teamMemberId}

Add a member to the project › path Parameters

projectId

string · required

teamMemberId

string · required

Add a member to the project › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Add a member to the project › Responses

200

message

string · const · required

Const value: Team member added to project successfully.

Remove a member from the project

DELETE

https://api.lettermint.co/v1

/projects/{projectId}/members/{teamMemberId}

Remove a member from the project › path Parameters

projectId

string · required

teamMemberId

string · required

Remove a member from the project › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Remove a member from the project › Responses

200

message

string · const · required

Const value: Team member removed from project successfully.

List routes for a project

GET

https://api.lettermint.co/v1

/projects/{projectId}/routes

List routes for a project › path Parameters

projectId

string · required

List routes for a project › query Parameters

sort

string

Available sorts are name, slug, created_at. You can sort by multiple options by separating them with a comma. To sort in descending order, use - sign in front of the sort, for example: -name.

Default: -created_at

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.

filter[route_type]

string · enum

Enum values:

transactional

broadcast

inbound

filter[is_default]

boolean

filter[search]

string

Search by name or slug

List routes for a project › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

List routes for a project › Responses

200

Paginated set of RouteListData

object[] · 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

Create a new route

POST

https://api.lettermint.co/v1

/projects/{projectId}/routes

Create a new route › path Parameters

projectId

string · required

Create a new route › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Create a new route › Request Body

name

string · maxLength: 255 · required

route_type

string · enum · required

Enum values:

transactional

broadcast

inbound

slug

string | null · maxLength: 255

Create a new route › Responses

object · required

message

string · const · required

Const value: Route created successfully.

POST/projects/{projectId}/routes

curl --request POST \
  --url https://api.lettermint.co/v1/projects/:projectId/routes \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "route_type": "transactional",
  "slug": "slug"
}
'

shell

Example Request Body

{
  "name": "name",
  "route_type": "transactional",
  "slug": "slug"
}

json

Example Responses

{
  "data": {
    "id": "id",
    "project_id": "project_id",
    "slug": "slug",
    "name": "name",
    "route_type": "transactional",
    "is_default": true,
    "inbound_address": "inbound_address",
    "inbound_domain": "inbound_domain",
    "inbound_domain_verified_at": "2024-08-25T15:00:00Z",
    "inbound_spam_threshold": 0,
    "attachment_delivery": "attachment_delivery",
    "project": {
      "id": "id",
      "name": "name",
      "smtp_enabled": true,
      "default_route_id": "default_route_id",
      "token_generated_at": "2024-08-25T15:00:00Z",
      "token_last_used_at": "2024-08-25T15:00:00Z",
      "token_last_used_ip": "token_last_used_ip",
      "routes": [
        null
      ],
      "routes_count": 0,
      "domains": [
        {
          "id": "id",
          "domain": "domain",
          "status_changed_at": "2024-08-25T15:00:00Z",
          "dns_records": [
            {
              "id": "id",
              "type": "TXT",
              "hostname": "hostname",
              "fqdn": "fqdn",
              "content": "content",
              "status": "active",
              "verified_at": "verified_at",
              "last_checked_at": "2024-08-25T15:00:00Z"
            }
          ],
          "projects": [
            {
              "id": "id",
              "name": "name"
            }
          ],
          "created_at": "2024-08-25T15:00:00Z"
        }
      ],
      "domains_count": 0,
      "team_members": [
        {
          "id": "id",
          "user": {
            "id": "id",
            "name": "name",
            "email": "email",
            "avatar": "avatar"
          },
          "role": "role",
          "joined_at": "2024-08-25T15:00:00Z"
        }
      ],
      "team_members_count": 0,
      "last_28_days": {
        "messages_transactional": 0,
        "messages_broadcast": 0,
        "messages_inbound": 0,
        "deliverability": 0
      },
      "created_at": "created_at",
      "updated_at": "updated_at"
    },
    "webhooks_count": 0,
    "suppressed_recipients_count": 0,
    "statistics": {},
    "created_at": "2024-08-25T15:00:00Z",
    "updated_at": "2024-08-25T15:00:00Z"
  },
  "message": "Route created successfully."
}

json

application/json

Get route details

GET

https://api.lettermint.co/v1

/routes/{routeId}

Get route details › path Parameters

routeId

string · required

Get route details › query Parameters

include

string

Available includes are project, projectCount, projectExists, statistics. You can include multiple options by separating them with a comma.

Get route details › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Get route details › Responses

200

RouteData

id

string · required

project_id

string · required

slug

string · required

name

string · required

route_type

string · enum · required

Enum values:

transactional

broadcast

inbound

is_default

boolean · required

created_at

string · date-time · required

updated_at

string · date-time · required

inbound_address

string

inbound_domain

string

inbound_domain_verified_at

string · date-time

inbound_spam_threshold

number

attachment_delivery

string

object

webhooks_count

integer

suppressed_recipients_count

integer

GET/routes/{routeId}

curl --request GET \
  --url https://api.lettermint.co/v1/routes/:routeId \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "id": "id",
  "project_id": "project_id",
  "slug": "slug",
  "name": "name",
  "route_type": "transactional",
  "is_default": true,
  "inbound_address": "inbound_address",
  "inbound_domain": "inbound_domain",
  "inbound_domain_verified_at": "2024-08-25T15:00:00Z",
  "inbound_spam_threshold": 0,
  "attachment_delivery": "attachment_delivery",
  "project": {
    "id": "id",
    "name": "name",
    "smtp_enabled": true,
    "default_route_id": "default_route_id",
    "token_generated_at": "2024-08-25T15:00:00Z",
    "token_last_used_at": "2024-08-25T15:00:00Z",
    "token_last_used_ip": "token_last_used_ip",
    "routes": [
      null
    ],
    "routes_count": 0,
    "domains": [
      {
        "id": "id",
        "domain": "domain",
        "status_changed_at": "2024-08-25T15:00:00Z",
        "dns_records": [
          {
            "id": "id",
            "type": "TXT",
            "hostname": "hostname",
            "fqdn": "fqdn",
            "content": "content",
            "status": "active",
            "verified_at": "verified_at",
            "last_checked_at": "2024-08-25T15:00:00Z"
          }
        ],
        "projects": [
          {
            "id": "id",
            "name": "name"
          }
        ],
        "created_at": "2024-08-25T15:00:00Z"
      }
    ],
    "domains_count": 0,
    "team_members": [
      {
        "id": "id",
        "user": {
          "id": "id",
          "name": "name",
          "email": "email",
          "avatar": "avatar"
        },
        "role": "role",
        "joined_at": "2024-08-25T15:00:00Z"
      }
    ],
    "team_members_count": 0,
    "last_28_days": {
      "messages_transactional": 0,
      "messages_broadcast": 0,
      "messages_inbound": 0,
      "deliverability": 0
    },
    "created_at": "created_at",
    "updated_at": "updated_at"
  },
  "webhooks_count": 0,
  "suppressed_recipients_count": 0,
  "statistics": {},
  "created_at": "2024-08-25T15:00:00Z",
  "updated_at": "2024-08-25T15:00:00Z"
}

json

application/json

Update route settings

PUT

https://api.lettermint.co/v1

/routes/{routeId}

Update route settings › path Parameters

routeId

string · required

Update route settings › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Update route settings › Request Body

name

string | null · maxLength: 255

object

Update route settings › Responses

object · required

message

string · const · required

Const value: Route updated successfully.

PUT/routes/{routeId}

curl --request PUT \
  --url https://api.lettermint.co/v1/routes/:routeId \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "settings": {
    "track_opens": true,
    "track_clicks": true,
    "disable_hosted_unsubscribe": true
  },
  "inbound_settings": {
    "inbound_domain": "inbound_domain",
    "inbound_spam_threshold": 0,
    "attachment_delivery": "inline"
  }
}
'

shell

Example Request Body

{
  "name": "name",
  "settings": {
    "track_opens": true,
    "track_clicks": true,
    "disable_hosted_unsubscribe": true
  },
  "inbound_settings": {
    "inbound_domain": "inbound_domain",
    "inbound_spam_threshold": 0,
    "attachment_delivery": "inline"
  }
}

json

Example Responses

{
  "data": {
    "id": "id",
    "project_id": "project_id",
    "slug": "slug",
    "name": "name",
    "route_type": "transactional",
    "is_default": true,
    "inbound_address": "inbound_address",
    "inbound_domain": "inbound_domain",
    "inbound_domain_verified_at": "2024-08-25T15:00:00Z",
    "inbound_spam_threshold": 0,
    "attachment_delivery": "attachment_delivery",
    "project": {
      "id": "id",
      "name": "name",
      "smtp_enabled": true,
      "default_route_id": "default_route_id",
      "token_generated_at": "2024-08-25T15:00:00Z",
      "token_last_used_at": "2024-08-25T15:00:00Z",
      "token_last_used_ip": "token_last_used_ip",
      "routes": [
        null
      ],
      "routes_count": 0,
      "domains": [
        {
          "id": "id",
          "domain": "domain",
          "status_changed_at": "2024-08-25T15:00:00Z",
          "dns_records": [
            {
              "id": "id",
              "type": "TXT",
              "hostname": "hostname",
              "fqdn": "fqdn",
              "content": "content",
              "status": "active",
              "verified_at": "verified_at",
              "last_checked_at": "2024-08-25T15:00:00Z"
            }
          ],
          "projects": [
            {
              "id": "id",
              "name": "name"
            }
          ],
          "created_at": "2024-08-25T15:00:00Z"
        }
      ],
      "domains_count": 0,
      "team_members": [
        {
          "id": "id",
          "user": {
            "id": "id",
            "name": "name",
            "email": "email",
            "avatar": "avatar"
          },
          "role": "role",
          "joined_at": "2024-08-25T15:00:00Z"
        }
      ],
      "team_members_count": 0,
      "last_28_days": {
        "messages_transactional": 0,
        "messages_broadcast": 0,
        "messages_inbound": 0,
        "deliverability": 0
      },
      "created_at": "created_at",
      "updated_at": "updated_at"
    },
    "webhooks_count": 0,
    "suppressed_recipients_count": 0,
    "statistics": {},
    "created_at": "2024-08-25T15:00:00Z",
    "updated_at": "2024-08-25T15:00:00Z"
  },
  "message": "Route updated successfully."
}

json

application/json

Delete a route

DELETE

https://api.lettermint.co/v1

/routes/{routeId}

Delete a route › path Parameters

routeId

string · required

Delete a route › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Delete a route › Responses

200

message

string · const · required

Const value: Route deleted successfully.

Verify inbound domain for a route

POST

https://api.lettermint.co/v1

/routes/{routeId}/verify-inbound-domain

Verify inbound domain for a route › path Parameters

routeId

string · required

Verify inbound domain for a route › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Verify inbound domain for a route › Responses

object · required

Domain Webhook