Skip to main content
POST
/
v1
/
send
curl --request POST \
  --url https://api.mailglyph.com/v1/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "[email protected]",
  "from": "My Company <[email protected]>",
  "subject": "Password Reset Request",
  "body": "<h1>Reset Your Password</h1><p>Click the link to reset: {{resetLink}}</p>",
  "data": {
    "resetLink": "https://example.com/reset/abc123"
  }
}
'
{
  "success": true,
  "data": {
    "emails": [
      {
        "contact": {
          "id": "cnt_abc123",
          "email": "[email protected]"
        },
        "email": "ac32f08e-c6b9-45d3-9824-a73dff1e3bbf"
      }
    ],
    "timestamp": "2025-01-15T10:30:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.mailglyph.com/llms.txt

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

Authorizations

​
Authorization
string
header
required

API Key authentication. Secret keys (sk_*) are required for all endpoints except /v1/track. Public keys (pk_*) only work with the /v1/track endpoint for client-side event tracking. Workspaces can have multiple active keys, and sender-domain operations enforce per-key domain scope when configured.

Body

application/json
​
to
required

Recipient email(s). Can be a string, an object with {name, email}, or an array of either. Maximum 50 recipients per request.

​
from
required

Sender email address (requires verified domain). Required unless using a template that has a 'from' address configured. Can be a string (e.g., "[email protected]" or "My App <[email protected]>") or an object with {name, email} (e.g., {name: "My App", email: "[email protected]"}).

​
subject
string

Email subject (required if no template)

​
body
string

Email body HTML (required if no template)

​
text
string

The plain text version of the message. If not provided, the body will be used to generate a plain text version. You can opt out of this behavior by setting value to an empty string.

​
template
string

Template ID to use for this email. When provided, uses the template's subject, body, from, and reply-to settings. You can override these by explicitly providing subject, body, from, or reply fields in the request. Template variables are populated from the data field.

​
name
string

Sender display name (alternative to using from.name)

​
subscribed
boolean
default:false

Whether recipient is subscribed to marketing emails. Defaults to false for transactional emails.

​
data
Example object · object

Optional template variables. Choose Empty object if you do not want to send any example preset keys.

Example:
{
  "resetLink": "https://example.com/reset/abc123"
}
​
headers
object

Custom email headers

​
reply
string<email>

Reply-to address

​
attachments
object[]

Email attachments (max 10 attachments, 10MB total)

Maximum array length: 10

Response

Email queued successfully

​
success
boolean
​
data
object