Send email

API key with format "Bearer {your-api-key}"

Sender email address. Must be in one of these formats:

• "Name" <email@domain.com>
• Name <email@domain.com>
• email@domain.com

Recipient email addresses. Maximum 50 recipients allowed.

Email subject line

HTML content of the email. Required if template_id is not provided.

• Maximum size: 40MB
• Cannot be used together with template_id

ID of the email template. Required if html is not provided.

• Cannot be used together with html
• Must reference an existing template
• Template must have valid HTML content

Plain text version of the email. Maximum size 10MB.

CC recipient addresses. Maximum 50 recipients allowed.

BCC recipient addresses. Maximum 50 recipients allowed.

Reply-to addresses. Maximum 50 recipients allowed.

Template variables for personalization. Maximum 100 properties allowed. Variables are referenced in templates using double curly braces: {{variable_name}}

Note: When using templates with variables (e.g., {{variable_name}}):

• Default values can be defined in the template
• Values provided through this API field will override any template defaults
• Default values will be used when:
  • The variable is not provided at all
  • The variable is explicitly set to null
  • When using object format and value is null or undefined

Each variable can be:

• A string
• A number
• An object with:
  • value: string, number, or null
  • default: string or number (used when value is null)

File attachments. You can attach files using either base64 encoded content or a URL path.

Limits:

• Maximum 10 attachments allowed
• Total size must not exceed 40MB for all attachments combined
• Each attachment must have:
  • filename (required)
  • Either path OR content (one must be provided)
  • content_type (optional, but highly recommended)
    • If not provided, falls back to application/octet-stream

Tip: You can upload files through the "Assets" in the template page. These files will be served through our CDN, ensuring they are cached and optimized for delivery.

Example using base64 content:

{
  "attachments": [{
    "filename": "document.pdf",
    "content": "base64EncodedString==",
    "content_type": "application/pdf"
  }]
}

Example using URL path:

{
  "attachments": [{
    "filename": "document.pdf",
    "path": "https://example.com/files/document.pdf",
    "content_type": "application/pdf"
  }]
}

Example with multiple attachments:

{
  "attachments": [
    {
      "filename": "document.pdf",
      "content": "base64EncodedString==",
      "content_type": "application/pdf"
    },
    {
      "filename": "image.jpg",
      "path": "https://example.com/files/image.jpg",
      "content_type": "image/jpeg"
    }
  ]
}

Common errors:

• "Too many attachments: 11. Max is 10"
• "Total attachments size exceeds maximum of 40MB"
• "attachments[0].filename is required"
• "attachments[0] must have either path or content"
• "attachments[0].path must be a valid URL"
• "attachments[0].content must be a valid base64 encoded string"

Unique identifier for the sent email