Your AWS SES. Your dedicated Mailat. See how it works
Documentation

The email API.

Build on your own Mailat instance. Every route, its contract and the access it needs, in one place.

237 operations · Contract 2026-10-04

API keys are supported only on the routes marked “API key.” Human-session routes require an authenticated Mailat user; public and callback routes can have separate token or provider checks. Legacy JMAP routes require Stalwart.

Send requests to your instance, such as https://mail.example.com. Mailat.co is the hosting dashboard.

Start with authenticationDownload OpenAPI

Source base d06861e, with documentation corrections in this snapshot. SHA-256: db66e1442f2715e2dcdbd93225ae20e9ab058d385bda78186f251390b1c86980.

237 matching operations

POST
/api/v1/compose/attachments

Upload Attachment

API key · email:send
POST
/api/v1/compose/drafts

Save Draft

API key · email:send
DELETE
/api/v1/compose/drafts/{id}

Delete Draft

API key · email:send
PUT
/api/v1/compose/drafts/{id}

Update Draft

API key · email:send
GET
/api/v1/compose/forward/{id}

Get Forward Context

API key · email:read
GET
/api/v1/compose/reply/{id}

Get Reply Context

API key · email:read
POST
/api/v1/compose/send

Send Email

API key · email:send
GET
/api/v1/contacts

List contacts

API key · contacts:manage
POST
/api/v1/contacts

Create contacts

API key · contacts:manage
DELETE
/api/v1/contacts/{uuid}

Delete contacts

API key · contacts:manage
GET
/api/v1/contacts/{uuid}

Get contacts

API key · contacts:manage
PUT
/api/v1/contacts/{uuid}

Update contacts

API key · contacts:manage
GET
/api/v1/contacts/{uuid}/consent-audit

Get Consent Audit Trail

API key · contacts:manage
GET
/api/v1/contacts/{uuid}/export

Export Contact Data

API key · contacts:manage
DELETE
/api/v1/contacts/{uuid}/gdpr

Delete Contact Data

API key · contacts:manage
POST
/api/v1/contacts/export

Export

API key · contacts:manage
POST
/api/v1/contacts/import

Import

API key · contacts:manage
POST
/api/v1/contacts/unsubscribe

Unsubscribe

API key · contacts:manage
GET
/api/v1/domains

List domains

API key · domains:read
POST
/api/v1/domains

Create domains

API key · domains:manage
DELETE
/api/v1/domains/{uuid}

Delete domains

API key · domains:manage
GET
/api/v1/domains/{uuid}

Get domains

API key · domains:read
GET
/api/v1/domains/{uuid}/dmarc

DMARC

API key · domains:read
POST
/api/v1/domains/{uuid}/dns/cloudflare

Add DNSTo Cloudflare

API key · domains:manage
GET
/api/v1/domains/{uuid}/sending-status

Sending Status

API key · domains:read
GET
/api/v1/domains/{uuid}/ses-status

Check SESStatus

API key · domains:read
POST
/api/v1/domains/{uuid}/ses-verify

Initiate SES

API key · domains:manage
POST
/api/v1/domains/{uuid}/setup-sending

Setup Sending

API key · domains:manage
POST
/api/v1/domains/{uuid}/verify

Verify

API key · domains:manage
POST
/api/v1/domains/cloudflare/zones

Get Cloudflare Zones

API key · domains:manage
POST
/api/v1/emails

Send Email

API key · email:send
DELETE
/api/v1/emails/{id}

Cancel Email

API key · email:manage
GET
/api/v1/emails/{id}

Get Email Status

API key · email:read
POST
/api/v1/emails/batch

Batch Send Email

API key · email:send
GET
/api/v1/identities

List identities

API key · identities:read
POST
/api/v1/identities

Create identities

API key · identities:manage
DELETE
/api/v1/identities/{uuid}

Delete identities

API key · identities:manage
GET
/api/v1/identities/{uuid}

Get identities

API key · identities:read
PUT
/api/v1/identities/{uuid}

Update identities

API key · identities:manage
POST
/api/v1/identities/{uuid}/catch-all

Update identities

API key · identities:manage
GET
/api/v1/inbox

Get Inbox

API key · email:readLegacy · Stalwart / JMAP
GET
/api/v1/inbox/changes

Changes

API key · email:read
POST
/api/v1/inbox/delete

Delete Emails

API key · email:manageLegacy · Stalwart / JMAP
GET
/api/v1/inbox/emails/{id}

Get Email

API key · email:readLegacy · Stalwart / JMAP
GET
/api/v1/inbox/filters

List Filters

API key · email:read
POST
/api/v1/inbox/filters

Save Filter

API key · email:manage
DELETE
/api/v1/inbox/filters/{uuid}

Delete Filter

API key · email:manage
GET
/api/v1/inbox/filters/{uuid}

Get Filter

API key · email:read
PUT
/api/v1/inbox/filters/{uuid}

Save Filter

API key · email:manage
POST
/api/v1/inbox/filters/{uuid}/test

Test Filter

API key · email:manage
GET
/api/v1/inbox/labels

List Labels

API key · email:read
POST
/api/v1/inbox/labels

Save Label

API key · email:manage
DELETE
/api/v1/inbox/labels/{uuid}

Delete Label

API key · email:manage
PUT
/api/v1/inbox/labels/{uuid}

Save Label

API key · email:manage
GET
/api/v1/inbox/mailboxes

Get Mailboxes

API key · email:readLegacy · Stalwart / JMAP
POST
/api/v1/inbox/mark-read

Mark Read

API key · email:manageLegacy · Stalwart / JMAP
POST
/api/v1/inbox/move

Move Emails

API key · email:manageLegacy · Stalwart / JMAP
GET
/api/v1/inbox/received

List Emails

API key · email:read
GET
/api/v1/inbox/received/{uuid}

Get Email

API key · email:read
GET
/api/v1/inbox/received/{uuid}/attachments/{attachmentUuid}

Download Attachment

API key · email:read
GET
/api/v1/inbox/received/counts

Get Counts

API key · email:read
POST
/api/v1/inbox/received/labels

Label Emails

API key · email:manage
POST
/api/v1/inbox/received/mark

Mark Emails

API key · email:manage
POST
/api/v1/inbox/received/move

Move Emails

API key · email:manage
POST
/api/v1/inbox/received/star

Star Emails

API key · email:manage
POST
/api/v1/inbox/received/trash

Trash Emails

API key · email:manage
GET
/api/v1/inbox/search

Search

API key · email:readLegacy · Stalwart / JMAP
POST
/api/v1/inbox/setup

Setup Receiving

API key · domains:manage
GET
/api/v1/inbox/threads/{id}

Get Thread

API key · email:readLegacy · Stalwart / JMAP
POST
/api/v1/inbox/toggle-flag

Toggle Flag

API key · email:manageLegacy · Stalwart / JMAP
GET
/api/v1/labels

List Labels

API key · email:read
POST
/api/v1/labels

Save Label

API key · email:manage
DELETE
/api/v1/labels/{uuid}

Delete Label

API key · email:manage
PUT
/api/v1/labels/{uuid}

Save Label

API key · email:manage
GET
/api/v1/lists

List lists

API key · contacts:manage
POST
/api/v1/lists

Create lists

API key · contacts:manage
DELETE
/api/v1/lists/{uuid}

Delete lists

API key · contacts:manage
GET
/api/v1/lists/{uuid}

Get lists

API key · contacts:manage
PUT
/api/v1/lists/{uuid}

Update lists

API key · contacts:manage
DELETE
/api/v1/lists/{uuid}/contacts

Remove Contacts

API key · contacts:manage
GET
/api/v1/lists/{uuid}/contacts

Get List Contacts

API key · contacts:manage
POST
/api/v1/lists/{uuid}/contacts

Add Contacts

API key · contacts:manage
POST
/api/v1/lists/{uuid}/contacts/import

Import Contacts To List

API key · contacts:manage
POST
/api/v1/lists/{uuid}/contacts/manual

Manual Add Contact To List

API key · contacts:manage
GET
/api/v1/rules

List Rules

API key · email:read
POST
/api/v1/rules

Create Rule

API key · email:manage
DELETE
/api/v1/rules/{id}

Delete Rule

API key · email:manage
GET
/api/v1/rules/{id}

Get Rule

API key · email:read
PUT
/api/v1/rules/{id}

Update Rule

API key · email:manage
POST
/api/v1/rules/{id}/test

Test Rule

API key · email:manage
POST
/api/v1/rules/reorder

Reorder Rules

API key · email:manage
GET
/api/v1/sse/connect

Connect

API key · email:read
GET
/api/v1/templates

List Templates

API key · templates:read
POST
/api/v1/templates

Create Template

API key · templates:manage
DELETE
/api/v1/templates/{uuid}

Delete Template

API key · templates:manage
GET
/api/v1/templates/{uuid}

Get Template

API key · templates:read
PUT
/api/v1/templates/{uuid}

Update Template

API key · templates:manage
POST
/api/v1/templates/{uuid}/preview

Preview Template

API key · templates:read
GET
/api/v1/webhook-deliveries

List Deliveries

API key · webhooks:manage
GET
/api/v1/webhook-deliveries/{uuid}

Get Delivery

API key · webhooks:manage
POST
/api/v1/webhook-deliveries/{uuid}/replay

Replay Delivery

API key · webhooks:manage
GET
/api/v1/webhook-triggers

List Webhook Triggers

API key · webhooks:manage
POST
/api/v1/webhook-triggers

Create Webhook Trigger

API key · webhooks:manage
DELETE
/api/v1/webhook-triggers/{id}

Delete Webhook Trigger

API key · webhooks:manage
GET
/api/v1/webhook-triggers/{id}

Get Webhook Trigger

API key · webhooks:manage
PUT
/api/v1/webhook-triggers/{id}

Update Webhook Trigger

API key · webhooks:manage
POST
/api/v1/webhook-triggers/{id}/rotate-secret

Rotate Webhook Trigger Secret

API key · webhooks:manage
POST
/api/v1/webhook-triggers/{id}/test

Test Webhook Trigger

API key · webhooks:manage
GET
/api/v1/webhook-triggers/types

Get Webhook Trigger Types

API key · webhooks:manage
GET
/api/v1/webhooks

List Webhooks

API key · webhooks:manage
POST
/api/v1/webhooks

Create Webhook

API key · webhooks:manage
DELETE
/api/v1/webhooks/{uuid}

Delete Webhook

API key · webhooks:manage
GET
/api/v1/webhooks/{uuid}

Get Webhook

API key · webhooks:manage
PUT
/api/v1/webhooks/{uuid}

Update Webhook

API key · webhooks:manage
GET
/api/v1/webhooks/{uuid}/calls

Get Webhook Calls

API key · webhooks:manage
POST
/api/v1/webhooks/{uuid}/rotate-secret

Rotate Secret

API key · webhooks:manage
POST
/api/v1/webhooks/{uuid}/test

Test Webhook

API key · webhooks:manage
GET
/api/v1/api-keys

List APIKeys

Human session
POST
/api/v1/api-keys

Create APIKey

Human session
DELETE
/api/v1/api-keys/{uuid}

Delete APIKey

Human session
POST
/api/v1/auth/2fa/disable

Disable2FA

Human session
POST
/api/v1/auth/2fa/enable

Setup2FA

Human session
POST
/api/v1/auth/2fa/verify

Verify2FA

Human session
POST
/api/v1/auth/change-password

Change Password

Human session
POST
/api/v1/auth/logout

Logout

Human session
GET
/api/v1/auth/me

Me

Human session
GET
/api/v1/auth/sessions

List Sessions

Human session
DELETE
/api/v1/auth/sessions/{uuid}

Revoke Session

Human session
POST
/api/v1/auth/sessions/revoke-all

Revoke All Sessions

Human session
POST
/api/v1/auth/stream-token

Stream Token

Human session
GET
/api/v1/auto-replies

List Auto Replies

Human session
POST
/api/v1/auto-replies

Create Auto Reply

Human session
DELETE
/api/v1/auto-replies/{id}

Delete Auto Reply

Human session
GET
/api/v1/auto-replies/{id}

Get Auto Reply

Human session
PUT
/api/v1/auto-replies/{id}

Update Auto Reply

Human session
GET
/api/v1/automations

List automations

Human session
POST
/api/v1/automations

Create automations

Human session
DELETE
/api/v1/automations/{uuid}

Delete automations

Human session
GET
/api/v1/automations/{uuid}

Get automations

Human session
PUT
/api/v1/automations/{uuid}

Update automations

Human session
POST
/api/v1/automations/{uuid}/activate

Activate

Human session
POST
/api/v1/automations/{uuid}/enroll

Enroll Contact

Human session
POST
/api/v1/automations/{uuid}/pause

Pause

Human session
GET
/api/v1/automations/{uuid}/stats

Get Stats

Human session
GET
/api/v1/branding

Get Branding

Human session
PUT
/api/v1/branding

Update Branding

Human session
GET
/api/v1/branding/css

Get Branding CSS

Human session
POST
/api/v1/branding/verify-domain

Verify Custom Domain

Human session
GET
/api/v1/campaigns

List campaigns

Human session
POST
/api/v1/campaigns

Create campaigns

Human session
DELETE
/api/v1/campaigns/{uuid}

Delete campaigns

Human session
GET
/api/v1/campaigns/{uuid}

Get campaigns

Human session
PUT
/api/v1/campaigns/{uuid}

Update campaigns

Human session
POST
/api/v1/campaigns/{uuid}/cancel

Cancel

Human session
POST
/api/v1/campaigns/{uuid}/pause

Pause

Human session
POST
/api/v1/campaigns/{uuid}/preview

Preview

Human session
POST
/api/v1/campaigns/{uuid}/resume

Resume

Human session
POST
/api/v1/campaigns/{uuid}/schedule

Schedule

Human session
POST
/api/v1/campaigns/{uuid}/send

Send Now

Human session
GET
/api/v1/campaigns/{uuid}/stats

Get Stats

Human session
POST
/api/v1/campaigns/{uuid}/test

Send Test

Human session
GET
/api/v1/forwards

List Email Forwards

Human session
POST
/api/v1/forwards

Create Email Forward

Human session
DELETE
/api/v1/forwards/{id}

Delete Email Forward

Human session
GET
/api/v1/health/alerts

Get Alerts

Human session
POST
/api/v1/health/alerts/{id}/acknowledge

Acknowledge Alert

Human session
POST
/api/v1/health/blacklist-check

Check Blacklists

Human session
GET
/api/v1/health/logs

Get Delivery Logs

Human session
GET
/api/v1/health/quota

Get Quota Status

Human session
GET
/api/v1/health/reputation

Get Reputation Metrics

Human session
GET
/api/v1/health/ses-limits

Get SESLimits

Human session
GET
/api/v1/health/summary

Get Email Health Summary

Human session
POST
/api/v1/health/warmup

Start Warmup

Human session
GET
/api/v1/health/warmup/{ip}

Get Warmup Status

Human session
GET
/api/v1/health/warmup/schedules

Get Warmup Schedules

Human session
PUT
/api/v1/identities/{uuid}/password

Update Password

Human session
POST
/api/v1/oauth/{provider}/connect

Connect Provider

Human session
GET
/api/v1/oauth/connections

Get Connections

Human session
POST
/api/v1/push/subscribe

Subscribe Push

Human session
GET
/api/v1/push/subscriptions

List Push Subscriptions

Human session
PUT
/api/v1/push/subscriptions/{uuid}/preferences

Update Push Preferences

Human session
POST
/api/v1/push/unsubscribe

Unsubscribe Push

Human session
GET
/api/v1/push/vapid-key

Get VAPIDKey

Human session
POST
/api/v1/security/2fa/backup-codes

Regenerate Backup Codes

Human session
POST
/api/v1/security/2fa/disable

Disable2FA

Human session
POST
/api/v1/security/2fa/setup

Setup2FA

Human session
GET
/api/v1/security/2fa/status

Get2FAStatus

Human session
POST
/api/v1/security/2fa/verify

Verify2FA

Human session
GET
/api/v1/security/audit-logs

List Audit Logs

Human session
GET
/api/v1/security/events

Get Security Events

Human session
GET
/api/v1/security/my-activity

Get My Activity

Human session
GET
/api/v1/security/sessions

List Sessions

Human session
DELETE
/api/v1/security/sessions/{uuid}

Revoke Session

Human session
POST
/api/v1/security/sessions/revoke-all

Revoke All Sessions

Human session
POST
/api/v1/security/webauthn/authenticate/begin

Begin Web Authn Authentication

Human session
POST
/api/v1/security/webauthn/authenticate/finish

Finish Web Authn Authentication

Human session
GET
/api/v1/security/webauthn/credentials

List Web Authn Credentials

Human session
DELETE
/api/v1/security/webauthn/credentials/{uuid}

Delete Web Authn Credential

Human session
POST
/api/v1/security/webauthn/register/begin

Begin Web Authn Registration

Human session
POST
/api/v1/security/webauthn/register/finish

Finish Web Authn Registration

Human session
GET
/api/v1/settings

Get Settings

Human session
PUT
/api/v1/settings

Update Settings

Human session
POST
/api/v1/settings/aws/provision

Provision Resources

Human session
POST
/api/v1/settings/aws/validate

Validate Credentials

Human session
GET
/api/v1/shared-mailboxes

List Shared Mailboxes

Human session
POST
/api/v1/shared-mailboxes

Create Shared Mailbox

Human session
DELETE
/api/v1/shared-mailboxes/{id}

Delete Shared Mailbox

Human session
GET
/api/v1/shared-mailboxes/{id}

Get Shared Mailbox

Human session
GET
/api/v1/shared-mailboxes/{id}/members

List Shared Mailbox Members

Human session
POST
/api/v1/shared-mailboxes/{id}/members

Add Shared Mailbox Member

Human session
DELETE
/api/v1/shared-mailboxes/{id}/members/{userId}

Remove Shared Mailbox Member

Human session
GET
/api/v1/sieve-scripts

List Sieve Scripts

Human session
POST
/api/v1/sieve-scripts

Create Sieve Script

Human session
DELETE
/api/v1/sieve-scripts/{id}

Delete Sieve Script

Human session
GET
/api/v1/sieve-scripts/{id}

Get Sieve Script

Human session
PUT
/api/v1/sieve-scripts/{id}

Update Sieve Script

Human session
POST
/api/v1/sieve-scripts/validate

Validate Sieve Script

Human session
POST
/api/v1/auth/2fa/challenge

Complete Challenge

Public / special auth
POST
/api/v1/auth/login

Login

Public / special auth
POST
/api/v1/auth/register

Register

Public / special auth
GET
/api/v1/auth/register-status

Register Status

Public / special auth
GET
/api/v1/confirm/{token}

Confirm Double Opt In

Public / special auth
POST
/api/v1/forwards/{id}/verify

Verify Email Forward

Public / special auth
GET
/api/v1/health

Health

Public / special auth
DELETE
/api/v1/oauth/{provider}

Disconnect Provider

Public / special auth
GET
/api/v1/oauth/{provider}

Initiate OAuth

Public / special auth
GET
/api/v1/oauth/{provider}/callback

Handle Callback

Public / special auth
GET
/api/v1/oauth/providers

Get Providers

Public / special auth
GET
/api/v1/preferences/{token}

Get Preferences

Public / special auth
PUT
/api/v1/preferences/{token}

Update Preferences

Public / special auth
GET
/api/v1/ready

Ready

Public / special auth
GET
/api/v1/tracking/click/{token}

Track Click

Public / special auth
GET
/api/v1/tracking/open/{token}

Track Open

Public / special auth
DELETE
/api/v1/unsubscribe/{token}

Confirm Unsubscribe

Public / special auth
GET
/api/v1/unsubscribe/{token}

Get Unsubscribe Page

Public / special auth
POST
/api/v1/unsubscribe/{token}

One Click Unsubscribe

Public / special auth
POST
/api/v1/webhooks/ses/incoming

Handle Incoming

Public / special auth
All guidesOpen your dashboard