Skip to main content
POST
/
v1
/
emails
Send Email
curl --request POST \
  --url https://api.example.com/v1/emails \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "<string>",
  "to": [
    "<string>"
  ],
  "subject": "<string>",
  "html": "<string>",
  "text": "<string>",
  "cc": [
    "<string>"
  ],
  "bcc": [
    "<string>"
  ],
  "reply_to": "<string>",
  "attachments": [
    {}
  ],
  "headers": {},
  "tags": {},
  "scheduled_for": "<string>"
}
'
​
from
string
required
Sender email address. Must be from a verified domain.
​
to
string | string[]
required
Recipient email address(es).
​
subject
string
required
Email subject line.
​
html
string
HTML content of the email.
​
text
string
Plain text content of the email.
​
cc
string | string[]
CC recipient(s).
​
bcc
string | string[]
BCC recipient(s).
​
reply_to
string
Reply-to email address.
​
attachments
array
Array of attachments. Each attachment has filename, content (base64), and content_type.
​
headers
object
Custom email headers.
​
tags
object
Custom tags for analytics.
​
scheduled_for
string
ISO 8601 datetime for scheduled sending.

​
Request

cURL
curl -X POST https://www.unosend.co/api/v1/emails \
  -H "Authorization: Bearer un_xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Hello World",
    "html": "<h1>Welcome!</h1><p>Thanks for signing up.</p>"
  }'

​
Response

200
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "from": "[email protected]",
  "to": ["[email protected]"],
  "created_at": "2024-01-15T10:30:00.000Z"
}