POST
/
email
Send Email
curl --request POST \
  --url https://sending.sendrapp.org/email \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recipients": [
    {
      "email": "jsmith@example.com",
      "name": "<string>",
      "substitutions": {}
    }
  ],
  "emailConfig": {
    "subject": "<string>",
    "from": "jsmith@example.com",
    "fromName": "<string>",
    "body": "<string>",
    "headers": {
      "X-Tenant": "<string>"
    }
  }
}'
{
  "status": "RUNNING",
  "message": "<string>",
  "limits": {
    "limit": 123,
    "used": 123,
    "remaining": 123,
    "requested": 123
  }
}
Send an email to one or multiple recipients. This endpoint supports HTML content and template variables for personalization. Maximum 100 subscribers per API call.

​
Features

  • Send to multiple recipients
  • HTML email content
  • Template variables for personalization
  • Custom headers support
  • Rate limiting information in response

​
Response

  • 200 OK: Email processing started successfully
  • 400 Bad Request: Invalid request parameters
  • 401 Unauthorized: Invalid API key
  • 429 Too Many Requests: Rate limit exceeded
The response includes rate limit information in the limits object, showing your current quota usage.

Authorizations

​
Authorization
string
header
required

Body

application/json

Email configuration and recipients. Maximum 100 subscribers per API call.

The body is of type object.

Response

200
application/json

Email processing started successfully

The response is of type object.