LettermintLettermint
  • Knowledge base
  • Community
  • Changelog
  • Support
  • Documentation
  • Sending API
  • Team API
Information
Generic
    Ping the APIget
Team
    Get team detailsgetUpdate team settingsputGet team usage statisticsgetGet team membersget
Domain
    List all domains for the teamgetCreate a new domainpostGet domain detailsgetDelete a domaindeleteVerify all DNS records for a domainpostVerify a specific DNS recordpostUpdate projects associated with a domainput
Project
    List all projects for the teamgetCreate a new projectpostGet project detailsgetUpdate project settingsputDelete a projectdeleteRotate project API tokenpostUpdate project membersputAdd a member to the projectpostRemove a member from the projectdeleteList routes for a projectgetCreate a new routepostGet route detailsgetUpdate route settingsputDelete a routedeleteVerify inbound domain for a routepost
Webhook
    List all webhooks for the teamgetCreate a new webhookpostGet webhook detailsgetUpdate webhook settingsputDelete a webhookdeleteTest a webhook by sending a sample payloadpostRegenerate webhook secretpostGet webhook deliveriesgetGet a specific webhook deliveryget
Message
    List messages for the teamgetGet message detailsgetGet message eventsgetGet message sourcegetGet message HTML contentgetGet message plain text contentget
Suppression
    List all suppressions for the teamgetAdd email(s) to suppression listpostRemove email from suppression listdelete
Stats
    Get message statisticsget
Schemas
Lettermint Team API
Lettermint Team API

Schemas


AttachmentDelivery

string · enum
Enum values:
inline
url

DnsRecordStatus

string · enum
Enum values:
active
failed
pending
active
The record is active and verified.
failed
The record could not be verified.
pending
The record is pending verification.

DomainData

id
​string · required
domain
​string · required
status_changed_at
​string | null · date-time · required
created_at
​string · date-time · required
​DomainDnsRecordData[]
​object[]

DomainDnsRecordData

id
​string · required
type
​RecordType · enum · required
Enum values:
TXT
CNAME
MX
hostname
​string · required
fqdn
​string · required
content
​string · required
status
​DnsRecordStatus · enum · required
active
The record is active and verified.
failed
The record could not be verified.
pending
The record is pending verification.
Enum values:
active
failed
pending
verified_at
​string | null · required
last_checked_at
​string | null · date-time · required

DomainListData

id
​string · required
domain
​string · required
status
​DomainStatus · enum · required
verified
The domain is active and verified.
partially_verified
Some DNS records of the domain could not be verified.
pending_verification
The domain is new and verification is pending.
failed_verification
The domain verification failed.
Enum values:
verified
partially_verified
pending_verification
failed_verification
status_changed_at
​string | null · date-time · required
created_at
​string · date-time · required

DomainStatus

string · enum
Enum values:
verified
partially_verified
pending_verification
failed_verification
verified
The domain is active and verified.
partially_verified
Some DNS records of the domain could not be verified.
pending_verification
The domain is new and verification is pending.
failed_verification
The domain verification failed.

InitialRoutes

string · enum
Enum values:
both
transactional
broadcast

MessageAttachmentData

size
​integer · required
Default: 0
filename
​string · required
Default: unknown
content_id
​string | null · required
content_type
​string · required
Default: application/octet-stream

MessageData

id
​string · required
type
​MessageType · enum · required
Enum values:
inbound
outbound
status
​MessageStatus · enum · required
Enum values:
pending
queued
suppressed
processed
delivered
opened
clicked
soft_bounced
status_changed_at
​string | null · date-time · required
tag
​string | null · required
from_email
​string · required
from_name
​string | null · required
reply_to
​array | null · required
subject
​string | null · required
​array | null · required
​array | null · required
​array | null · required
​array | null · required
​object | null · required
route_id
​string · required
created_at
​string · date-time · required
spam_score
​number | null
​SpamSymbol[]

MessageEventData

message_id
​string · required
event
​MessageEventType · enum · required
Enum values:
queued
processed
suppressed
delivered
soft_bounced
hard_bounced
spam_complaint
failed
​object | null · required
timestamp
​string · date-time · required

MessageEventType

string · enum
Enum values:
queued
processed
suppressed
delivered
soft_bounced
hard_bounced
spam_complaint
failed

MessageListData

id
​string · required
type
​MessageType · enum · required
Enum values:
inbound
outbound
status
​MessageStatus · enum · required
Enum values:
pending
queued
suppressed
processed
delivered
opened
clicked
soft_bounced
from_email
​string · required
from_name
​string | null · required
subject
​string | null · required
​array | null · required
​array | null · required
​array | null · required
reply_to
​array | null · required
tag
​string | null · required
created_at
​string · required

MessageRecipientData

email
​string · required
name
​string | null · required

MessageStatsData

messages_transactional
​integer · required
messages_broadcast
​integer · required
messages_inbound
​integer · required
deliverability
​number · required

MessageStatus

string · enum
Enum values:
pending
queued
suppressed
processed
delivered
opened
clicked
soft_bounced

MessageType

string · enum
Enum values:
inbound
outbound

Plan

string · enum
Enum values:
free
starter
growth
pro

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
​RouteData[]
routes_count
​integer
​DomainData[]
domains_count
​integer
​TeamMemberData[]
team_members_count
​integer
​

ProjectListData

id
​string · required
name
​string · required
smtp_enabled
​boolean · required
routes_count
​integer · required
domains_count
​integer · required
team_members_count
​integer · required
​MessageStatsData · required
created_at
​string · required
updated_at
​string · required

RecordType

string · enum
Enum values:
TXT
CNAME
MX

RouteData

id
​string · required
project_id
​string · required
slug
​string · required
name
​string · required
route_type
​RouteType · 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
​AttachmentDelivery · enum
Enum values:
inline
url
​ProjectData
webhooks_count
​integer
suppressed_recipients_count
​integer
​

RouteListData

id
​string · required
slug
​string · required
name
​string · required
route_type
​RouteType · enum · required
Enum values:
transactional
broadcast
inbound
is_default
​boolean · required
webhooks_count
​integer · required
suppressed_recipients_count
​integer · required
created_at
​string · date-time · required
updated_at
​string · date-time · required

RouteStatisticData

date
​string · required
sent_count
​integer · required
delivered_count
​integer · required
opened_count
​integer · required
clicked_count
​integer · required
hard_bounce_count
​integer · required
spam_complaint_count
​integer · required
inbound_received_count
​integer · required
effective_opened_count
​integer | null · required
machine_opened_count
​integer | null · required
machine_clicked_count
​integer | null · required

RouteType

string · enum
Enum values:
transactional
broadcast
inbound

SpamSymbol

name
​string · required
score
​number · required
options
​string[] · minItems: 1 · required
Default: []
description
​string | null · required

StatsDailyData

date
​string · required
sent
​integer · required
delivered
​integer · required
hard_bounced
​integer · required
spam_complaints
​integer · required
opened
​integer | null · required

Null when tracking is not enabled for this context

clicked
​integer | null · required

Null when tracking is not enabled for this context

​StatsInboundData · required
​required
​required
effective_opened
​integer | null · required
machine_opened
​integer | null · required
machine_clicked
​integer | null · required

StatsData

from
​string · required
to
​string · required
​StatsTotalsData · required
​StatsDailyData[] · required

StatsInboundData

received
​integer · required

StatsRequestData

from
​string · date · required
to
​string · date · required
project_id
​string | null · uuid
include_machine
​boolean
Default: false

StatsTotalsData

sent
​integer · required
delivered
​integer · required
hard_bounced
​integer · required
spam_complaints
​integer · required
opened
​integer | null · required

Null when tracking is not enabled for this context

clicked
​integer | null · required

Null when tracking is not enabled for this context

​StatsInboundData · required
​required
​required
effective_opened
​integer | null · required
machine_opened
​integer | null · required
machine_clicked
​integer | null · required

StatsTypeData

sent
​integer · required
hard_bounced
​integer · required
spam_complaints
​integer · required

StoreDomainData

domain
​string · maxLength: 255 · pattern: ^(?!:\/\/)(?=.{1,255… · required

StoreProjectData

name
​string · maxLength: 255 · required
smtp_enabled
​boolean
Default: false
initial_routes
​InitialRoutes · enum
Enum values:
both
transactional
broadcast
Default: both

StoreRouteData

name
​string · maxLength: 255 · required
route_type
​RouteType · enum · required
Enum values:
transactional
broadcast
inbound
slug
​string | null · maxLength: 255

StoreSuppressionData

reason
​SuppressionReason · enum · required
Enum values:
spam_complaint
hard_bounce
unsubscribe
manual
scope
​string · enum · required
Enum values:
team
project
route
email
​string | null · email · maxLength: 255
route_id
​string | null · uuid
project_id
​string | null · uuid
emails
​array | null · minItems: 1 · maxItems: 1000

StoreWebhookData

route_id
​string · required
name
​string · maxLength: 255 · required
url
​string · uri · maxLength: 500 · required
events
​WebhookEvent[] · minItems: 1 · required
Enum values:
message.created
message.sent
message.delivered
message.hard_bounced
message.soft_bounced
message.spam_complaint
message.failed
message.suppressed
enabled
​boolean | null
Default: true
include_machine_events
​boolean | null
Default: false

SuppressedRecipientData

id
​string · required
type
​SuppressionType · enum · required
Enum values:
email
domain
extension
value
​string · required
reason
​SuppressionReason · enum · required
Enum values:
spam_complaint
hard_bounce
unsubscribe
manual
scope
​SuppressionScope · enum · required
Enum values:
global
team
project
route
project_id
​string | null · required
route_id
​string | null · required
created_at
​string · date-time · required
updated_at
​string · date-time · required

SuppressionReason

string · enum
Enum values:
spam_complaint
hard_bounce
unsubscribe
manual

SuppressionScope

string · enum
Enum values:
global
team
project
route

SuppressionType

string · enum
Enum values:
email
domain
extension

TeamAddonData

type
​string | null · required
expires_at
​string | null · required

TeamData

id
​string · required
name
​string · required
type
​TeamType · enum · required
Enum values:
personal
business
plan
​Plan · enum · required
Enum values:
free
starter
growth
pro
tier
​VolumeTier · enum · required
Enum values:
300
10000
50000
125000
500000
750000
1000000
1500000
verified_at
​string | null · date-time · required
created_at
​string · date-time · required
features
​string[]
​TeamAddonData[]
domains_count
​integer
projects_count
​integer
members_count
​integer

TeamMemberData

id
​string · required
role
​string | null · required
joined_at
​string | null · date-time · required
​UserData

TeamType

string · enum
Enum values:
personal
business

TeamUsageDetailData

​TeamUsagePeriodData · required
​TeamUsagePeriodData[] · required

TeamUsagePeriodData

usage
​integer · required
last_incremented_at
​string | null · date-time · required
period_start
​string · date-time · required
period_end
​string · date-time · required

UpdateDomainProjectsData

project_ids
​string[] · minItems: 1 · required

UpdateProjectData

name
​string | null · maxLength: 255
smtp_enabled
​boolean | null
default_route_id
​string | null · uuid

UpdateProjectMembersData

team_member_ids
​string[] · minItems: 1 · required

UpdateRouteData

name
​string | null · maxLength: 255
​object
​object

UpdateTeamData

name
​string | null · maxLength: 255

UpdateWebhookData

name
​string · maxLength: 255
url
​string · uri · maxLength: 500
enabled
​boolean
include_machine_events
​boolean
events
​WebhookEvent[] · minItems: 1
Enum values:
message.created
message.sent
message.delivered
message.hard_bounced
message.soft_bounced
message.spam_complaint
message.failed
message.suppressed

UserData

id
​string · required
name
​string · required
email
​string · required
avatar
​string | null · required

VolumeTier

integer · enum
Enum values:
300
10000
50000
125000
500000
750000
1000000
1500000

WebhookData

id
​string · required
route_id
​string · required
name
​string · required
url
​string · required
events
​string[] · minItems: 1 · required
enabled
​boolean · required
include_machine_events
​boolean · required
last_called_at
​string | null · date-time · required
created_at
​string · date-time · required
updated_at
​string · date-time · required
secret
​string

WebhookDeliveryData

id
​string · required
webhook_id
​string · required
event_type
​WebhookEvent · enum · required
Enum values:
message.created
message.sent
message.delivered
message.hard_bounced
message.soft_bounced
message.spam_complaint
message.failed
message.suppressed
status
​WebhookDeliveryStatus · enum · required
Enum values:
pending
success
failed
client_error
server_error
timeout
attempt_number
​integer · required
http_status_code
​integer | null · required
duration_ms
​integer | null · required
payload
​string[] · minItems: 1 · required
response_body
​string | null · required
response_headers
​array | null · required
error_message
​string | null · required
delivered_at
​string | null · date-time · required
timestamp
​string · date-time · required

WebhookDeliveryListData

id
​string · required
webhook_id
​string · required
event_type
​WebhookEvent · enum · required
Enum values:
message.created
message.sent
message.delivered
message.hard_bounced
message.soft_bounced
message.spam_complaint
message.failed
message.suppressed
status
​WebhookDeliveryStatus · enum · required
Enum values:
pending
success
failed
client_error
server_error
timeout
attempt_number
​integer · required
http_status_code
​integer | null · required
duration_ms
​integer | null · required
delivered_at
​string | null · date-time · required
created_at
​string · date-time · required

WebhookDeliveryStatus

string · enum
Enum values:
pending
success
failed
client_error
server_error
timeout

WebhookEvent

string · enum
Enum values:
message.created
message.sent
message.delivered
message.hard_bounced
message.soft_bounced
message.spam_complaint
message.failed
message.suppressed

WebhookListData

id
​string · required
route_id
​string · required
name
​string · required
url
​string · required
events
​WebhookEvent[] · required
Enum values:
message.created
message.sent
message.delivered
message.hard_bounced
message.soft_bounced
message.spam_complaint
message.failed
message.suppressed
enabled
​boolean · required
last_called_at
​string | null · date-time · required
created_at
​string · date-time · required
updated_at
​string · date-time · required
On this page
  • AttachmentDelivery
  • DnsRecordStatus
  • DomainData
  • DomainDnsRecordData
  • DomainListData
  • DomainStatus
  • InitialRoutes
  • MessageAttachmentData
  • MessageData
  • MessageEventData
  • MessageEventType
  • MessageListData
  • MessageRecipientData
  • MessageStatsData
  • MessageStatus
  • MessageType
  • Plan
  • ProjectData
  • ProjectListData
  • RecordType
  • RouteData
  • RouteListData
  • RouteStatisticData
  • RouteType
  • SpamSymbol
  • StatsDailyData
  • StatsData
  • StatsInboundData
  • StatsRequestData
  • StatsTotalsData
  • StatsTypeData
  • StoreDomainData
  • StoreProjectData
  • StoreRouteData
  • StoreSuppressionData
  • StoreWebhookData
  • SuppressedRecipientData
  • SuppressionReason
  • SuppressionScope
  • SuppressionType
  • TeamAddonData
  • TeamData
  • TeamMemberData
  • TeamType
  • TeamUsageDetailData
  • TeamUsagePeriodData
  • UpdateDomainProjectsData
  • UpdateProjectData
  • UpdateProjectMembersData
  • UpdateRouteData
  • UpdateTeamData
  • UpdateWebhookData
  • UserData
  • VolumeTier
  • WebhookData
  • WebhookDeliveryData
  • WebhookDeliveryListData
  • WebhookDeliveryStatus
  • WebhookEvent
  • WebhookListData