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://docs.drin.run/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"