AutoSend Email API

Send transactional emails, manage contacts, and use templates via REST API.

Using JavaScript/TypeScript? See the SDK Guide for TypeScript examples with the autosendjs package.

Reference: API Guide | Official API Reference

Prerequisites

Complete these steps before using the API:

• Create Account — Sign up at autosend.com
• Add Domain — Settings → Domains → Add Domain → Select AWS region (docs)
• Configure DNS — Copy the generated records (DKIM, SPF, DMARC) to your DNS provider
• Verify Domain — Click "Verify Ownership" and wait for status to turn green (5-30 min)
• Get API Key — Settings → API Keys → Generate API Key (docs)
• Set Environment Variable — export AUTOSEND_API_KEY=as_your_key_here

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Base URL: https://api.autosend.com/v1

All POST/PUT requests must include Content-Type: application/json.

Email Operations

Send Email

POST /v1/mails/send

Send a single transactional email.

Response:

{
  "success": true,
  "data": { "emailId": "email_abc123" }
}

Bulk Send

POST /v1/mails/bulk

Send emails to multiple recipients with a shared sender, subject, and optional template.

Recipient object:

Limit: Maximum 100 recipients per bulk request.

Response:

{
  "success": true,
  "data": {
    "batchId": "batch_abc123",
    "totalRecipients": 2,
    "successCount": 2,
    "failedCount": 0
  }
}

Templates

POST /v1/mails/send with templateId

Send templated emails by passing a templateId and dynamicData instead of (or alongside) html/text.

Common template IDs:

Templates also work with bulk send — pass templateId and dynamicData in the bulk request body.

Contact Management

Create Contact

POST /v1/contacts

Response:

{
  "success": true,
  "data": {
    "id": "contact_abc123",
    "email": "user@example.com",
    "firstName": "Jane",
    "lastName": "Smith",
    "listIds": ["list_abc"],
    "customFields": {},
    "createdAt": "2025-01-15T00:00:00Z",
    "updatedAt": "2025-01-15T00:00:00Z"
  }
}

Get Contact

GET /v1/contacts/:id

Response: Returns the contact object (same shape as Create Contact response).

Upsert Contact

POST /v1/contacts/email

Create or update a contact by email address. If a contact with the given email exists, it is updated; otherwise a new contact is created.

Response: Returns the contact object (same shape as Create Contact response).

Delete Contact

DELETE /v1/contacts/:id

Response:

{
  "success": true
}

Error Handling

All errors return JSON with an error object:

{
  "success": false,
  "error": {
    "message": "The 'to' field is required",
    "code": "VALIDATION_FAILED",
    "details": []
  }
}