Skip to main content
POST
/
send
/
batch
Send multiple emails in a batch
curl --request POST \
  --url https://api.lettermint.co/v1/send/batch \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "route": "<string>",
    "from": "<string>",
    "to": [
      "<string>"
    ],
    "cc": [
      "<string>"
    ],
    "bcc": [
      "<string>"
    ],
    "reply_to": [
      "<string>"
    ],
    "subject": "<string>",
    "headers": {
      "X-Custom-Header": "custom-value",
      "X-Campaign-ID": "12345"
    },
    "metadata": {
      "user_id": "123",
      "campaign_id": "welcome-2025"
    },
    "tag": "welcome-email",
    "html": "<string>",
    "text": "<string>",
    "attachments": [
      {
        "filename": "<string>",
        "content": "<string>",
        "content_id": "<string>"
      }
    ]
  }
]'
[
  "<any>"
]

Headers

​
x-lettermint-token
string
​
Idempotency-Key
string

Body

application/json · SendBatchMailRequest · object[]
​
from
string
required
​
to
string[]
required
​
subject
string
required
Maximum length: 998
​
route
string
​
cc
string[]
​
bcc
string[]
​
reply_to
string[]
​
headers
string[]

Custom headers to include in the email.

Example:
{
  "X-Custom-Header": "custom-value",
  "X-Campaign-ID": "12345"
}
​
metadata
string[]

Metadata to track with the email (not added as email headers).

Example:
{
  "user_id": "123",
  "campaign_id": "welcome-2025"
}
​
tag
string | null

Tag to categorize and filter emails (alphanumeric, underscores, hyphens, spaces allowed).

Example:

"welcome-email"

​
html
string | null
Minimum length: 3
​
text
string | null
Minimum length: 3
​
attachments
object[]

Response

The response is of type any[].