API Reference
Contacts
Custom Fields
Campaigns
Contact Lists
Suppression Groups
Sending
Send Email
Sends a transactional or marketing email. Either templateId OR html/text content must be provided. If using a template, subject is optional.
POST
/
mails
/
send
curl --request POST \
--url https://api.autosend.com/v1/mails/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"to": {
"email": "[email protected]",
"name": "Jane Smith"
},
"cc": [
{"email": "[email protected]", "name": "CC User 1"},
{"email": "[email protected]", "name": "CC User 2"}
],
"bcc": [{"email": "[email protected]"}],
"from": {
"email": "[email protected]",
"name": "Your Company"
},
"subject": "Welcome to Our Platform!",
"html": "<h1>Welcome, {{name}}!</h1><p>Thanks for signing up.</p>",
"dynamicData": {
"name": "Jane"
},
"replyTo": {
"email": "[email protected]"
}
}'
{
"success": true,
"data": {
"emailId": "698afb75ff4bc5466e3a797a",
"message": "Email queued successfully.",
"totalRecipients": 1
}
}
Documentation Index
Fetch the complete documentation index at: https://docs.autosend.com/llms.txt
Use this file to discover all available pages before exploring further.
curl --request POST \
--url https://api.autosend.com/v1/mails/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"to": {
"email": "[email protected]",
"name": "Jane Smith"
},
"cc": [
{"email": "[email protected]", "name": "CC User 1"},
{"email": "[email protected]", "name": "CC User 2"}
],
"bcc": [{"email": "[email protected]"}],
"from": {
"email": "[email protected]",
"name": "Your Company"
},
"subject": "Welcome to Our Platform!",
"html": "<h1>Welcome, {{name}}!</h1><p>Thanks for signing up.</p>",
"dynamicData": {
"name": "Jane"
},
"replyTo": {
"email": "[email protected]"
}
}'
{
"success": true,
"data": {
"emailId": "698afb75ff4bc5466e3a797a",
"message": "Email queued successfully.",
"totalRecipients": 1
}
}
Authorizations
Bearer authentication header of the form Bearer
<token>, where <token> is your auth token.Body
Email data to sendRecipient email address and nameTo send to multiple recipients, use the send bulk email endpoint.
Show child attributes
Show child attributes
Email addressExample:
"[email protected]"Display nameExample:
"Jane Smith"Cc Recipients array of email address and name object
Show child attributes
Show child attributes
Email addressExample:
"[email protected]"Cc User nameExample:
"Cc User Name"Bcc Recipients array of email address and name object
Show child attributes
Show child attributes
Email addressExample:
"[email protected]"Bcc User nameExample:
"Bcc User Name"Sender email address (must be from a verified domain) and name
Show child attributes
Show child attributes
Email addressExample:
"[email protected]"Display nameExample:
"Your Company"Email subject line (max 998 characters). Required if not using templateId.Maximum length:
998Example: "Welcome to Our Platform!"HTML content of the email. Required if not using templateId.Handlebars Template Variables:Use Handlebars syntax for template variables in your HTML. Variables are wrapped in double curly braces: Provide the values for these variables in the
{{variableName}}.
Example:<h1>Hello {{firstName}}!</h1>
<p>Your order #{{orderNumber}} has been shipped.</p>
<p>Total: {{orderTotal}}</p>
dynamicData field.Example:html: "<p>Hello {{firstName}}! Sending this email via AutoSend.</p>"
Key-value pairs for template variable substitution (Handlebars syntax)Example:
dynamicData: {
"name": "Jane",
"firstName": "Jane",
"orderNumber": "ORD-12345",
"orderTotal": "$99.99"
}
Plain text version of the emailExample:
"Welcome! Thanks for signing up."ID of the email template to use. Required if not providing html/text.Example:
"A-abc123"Reply-to email address and name
Show child attributes
Show child attributes
Email addressExample:
"[email protected]"Display nameExample:
"John Doe"Key-value pairs for template variable substitution (Handlebars syntax)Example:
{
"name": "Jane",
"firstName": "Jane",
"orderNumber": "ORD-12345",
"orderTotal": "$99.99"
}
ID of the unsubscribe groupExample:
"unsub_group_123"Filename and content of attachments.
Example:
Maximum 20 files can be attached to an email. The total size of the email should be max 40MB after Base64 encoding of the attachments.
Show child attributes
Show child attributes
Filename of the attachmentExample:
"attachment.pdf"Base64-encoded content of the attachment
Content type of the attachment (e.g. application/pdf, image/png, image/jpeg)
File URL where the attachment is hosted (required if content is not provided)
Description of the attachment (optional)
Show all supported types
Show all supported types
.adp .app .asp .bas .bat
.cer .chm .cmd .com .cpl
.crt .csh .der .exe .fxp
.gadget .hlp .hta .inf .ins
.isp .its .js .jse .ksh
.lib .lnk .mad .maf .mag
.mam .maq .mar .mas .mat
.mau .mav .maw .mda .mdb
.mde .mdt .mdw .mdz .msc
.msh .msh1 .msh2 .mshxml .msh1xml
.msh2xml .msi .msp .mst .ops
.pcd .pif .plg .prf .prg
.reg .scf .scr .sct .shb
.shs .sys .ps1 .ps1xml .ps2
.ps2xml .psc1 .psc2 .tmp .url
.vb .vbe .vbs .vps .vsmacros
.vss .vst .vsw .vxd .ws
.wsc .wsf .wsh .xnkattachments: [
{
"fileName": "attachment.pdf",
"content": "base64-encoded-content",
"contentType": "application/pdf"
}
]
Response
Email queued successfullyIndicates if the request was successfulExample:
true⌘I
curl --request POST \
--url https://api.autosend.com/v1/mails/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"to": {
"email": "[email protected]",
"name": "Jane Smith"
},
"cc": [
{"email": "[email protected]", "name": "CC User 1"},
{"email": "[email protected]", "name": "CC User 2"}
],
"bcc": [{"email": "[email protected]"}],
"from": {
"email": "[email protected]",
"name": "Your Company"
},
"subject": "Welcome to Our Platform!",
"html": "<h1>Welcome, {{name}}!</h1><p>Thanks for signing up.</p>",
"dynamicData": {
"name": "Jane"
},
"replyTo": {
"email": "[email protected]"
}
}'
{
"success": true,
"data": {
"emailId": "698afb75ff4bc5466e3a797a",
"message": "Email queued successfully.",
"totalRecipients": 1
}
}