API Documentation

Learn how to programmatically send emails using our simple API.

Authentication

All API requests require authentication using your API key. You can find your API key in the dashboard settings.

Include your API key in the Authorization header as a Bearer token.

Send Email

POST/v1/send

Request Body

{
  "recipient": "string",     // Email address of the recipient (required)
  "email_type": "string",    // Type of email to send (required)
  "data": {                  // Custom data to be used in the email template (optional)
    [key: string]: any      // Any key-value pairs needed for your template
  }
}

Required Parameters

recipient - Valid email address of the recipient
email_type - String identifier for the email template type

Response

{
  "success": true,
  "message": "Email sent successfully",
  "data": {
    "id": "uuid",          // Email record ID
    "recipient": "string", // Recipient email address
    "sentAt": "string",    // ISO date string of when the email was sent
    "type": "string"      // The email type that was sent
  }
}

Rate Limiting

The API is limited to 10 requests per second per API key. If you exceed this limit, you'll receive a 429 Too Many Requests response.

Error Responses

400 Bad Request - Missing required fields or invalid email type

401 Unauthorized - Invalid or missing API key

404 Not Found - Email settings not found for the specified type

429 Too Many Requests - Rate limit exceeded

500 Internal Server Error - Server error

Code Examples

We recommend using the SDK for TypeScript projects. For more information, see the documentation.

curl -X POST https://api.emailssary.com/v1/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "recipient": "user@example.com",
  "email_type": "feedback",
  "data": {
    "name": "John Doe",
    "orderId": "123456",
    "product": "Premium Plan"
  }
}'