Skip to main content
POST
/
v1
/
emails
Send an email
curl --request POST \
  --url https://api.drin.run/v1/emails \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": {
    "email": "jsmith@example.com",
    "name": "<string>"
  },
  "to": [
    {
      "email": "jsmith@example.com",
      "name": "<string>"
    }
  ],
  "cc": [
    {
      "email": "jsmith@example.com",
      "name": "<string>"
    }
  ],
  "bcc": [
    {
      "email": "jsmith@example.com",
      "name": "<string>"
    }
  ],
  "replyTo": [
    {
      "email": "jsmith@example.com",
      "name": "<string>"
    }
  ],
  "subject": "<string>",
  "html": "<string>",
  "text": "<string>",
  "templateId": "<string>",
  "data": {},
  "headers": {},
  "tags": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "attachments": [
    {
      "filename": "<string>",
      "content": "<string>",
      "contentType": "<string>"
    }
  ],
  "scheduledAt": "2023-11-07T05:31:56Z"
}
'
{
  "id": "<string>",
  "status": "queued"
}

Documentation Index

Fetch the complete documentation index at: https://drin.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Your Drin API key, sent as Authorization: Bearer <key>.

Headers

X-Drin-Product
string

Names the sending project for account-wide keys (alias: X-Drin-Sender). Project-scoped keys may omit it.

Idempotency-Key
string

Make a POST safe to retry; honored 24h per project.

Body

application/json
from
object
required
to
object[]
required
Minimum array length: 1
cc
object[]
bcc
object[]
replyTo
object[]
subject
string

Required unless templateId is given.

html
string
text
string
templateId
string

Send a stored template by id or slug.

data
object

Merge variables for the template.

headers
object
tags
object[]
attachments
object[]
scheduledAt
string<date-time>

Schedule the send for a future time (ISO 8601).

Response

Accepted — the message was queued.

id
string
status
string
Example:

"queued"