Inboxjot
Dashboard

Emails

Auth Required

Send Email

POSThttps://api.inboxjot.com/v1/emails

Sends one transactional email. The API answers 202 Accepted and delivers the email in the background. Track it with the returned id, in Emails, or with webhooks.

Works with a Sending or a Full key. Send an optional Idempotency-Key header to retry safely. See Idempotency.

POST/v1/emails
curl -X POST https://api.inboxjot.com/v1/emails \
  -H "Authorization: Bearer $INBOXJOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.dev>",
    "to": "riti@example.com",
    "subject": "Your receipt from Acme",
    "html": "<p>Thanks for your order.</p>"
  }'
{
  "id": "eml_06d2mfk8r4tq9xv2bnc7s"
}

Accepted. Inboxjot sends the email in the background.

Body Parameters

fromstring | null

Sender on a verified domain, such as Acme <hello@acme.dev>, 3 to 320 characters. Required unless the template sets one.

tostring | string[]required

One address or a list. An address can carry a name, such as Jane <jane@example.com>, up to 640 characters each. At most 50 recipients across to, cc and bcc. Repeated addresses are sent once.

ccstring | string[]

Carbon copy recipients. One address or a list. An address can carry a name, such as Jane <jane@example.com>, up to 640 characters each.

bccstring | string[]

Blind carbon copy recipients. One address or a list. An address can carry a name, such as Jane <jane@example.com>, up to 640 characters each.

reply_tostring | string[]

Addresses that replies go to. One address or a list. An address can carry a name, such as Jane <jane@example.com>, up to 640 characters each. Defaults to the template’s reply-to.

subjectstring | null

Email subject, 1 to 998 characters, without line breaks. Required unless the template sets one.

htmlstring | null

HTML body. Send html, text or both, unless the template has content.

textstring | null

Plain text body.

templateobject | null

Send with a template. Its from, reply-to, subject and content fill the fields you leave out. The template content is used only when you send neither html nor text.

headersobject

Custom headers, up to 50, each with a string value and no line breaks. Allowed names are In-Reply-To, References, List-Unsubscribe, List-Unsubscribe-Post and most X- headers. A few X- names are reserved.

tagsobject[]

Up to 10 tags, stored with the email and passed to webhooks. Use each name once. email_id, workspace_id and campaign_id are reserved.

scheduled_atstring | null

ISO 8601 time with an offset, such as 2026-10-20T09:00:00Z, in the future and up to 30 days ahead. Leave it out to send now.

attachmentsobject[]

Up to 20 files, 30 MB in total. The whole request can be up to 45 MB.

Response

idstring

The email id. Use it with Retrieve Email.

Responses

POST/v1/emails
curl -X POST https://api.inboxjot.com/v1/emails \
  -H "Authorization: Bearer $INBOXJOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.dev>",
    "to": "riti@example.com",
    "subject": "Your receipt from Acme",
    "html": "<p>Thanks for your order.</p>"
  }'
{
  "id": "eml_06d2mfk8r4tq9xv2bnc7s"
}

Accepted. Inboxjot sends the email in the background.