Skip to main content

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.

Instead of hardcoding values, you can use placeholders that AutoSend replaces with actual data when sending the email via API. For example: 
Hi {{firstName}}, your order {{order_id}} has been shipped!
When the email is sent, it becomes: 
Hi Robert, your order #2341 has been shipped!
Variables make your emails more personalized, relevant, and engaging, all without manually editing each message.

​
How Variables Work

When you send a transactional email through the AutoSend Email API, you can include variables as key-value pairs in your request payload. AutoSend automatically replaces these placeholders with their corresponding values in the email template before delivery.

​
Example API Payload:

{
	"to": "[email protected]",
	"template_id": "A-b4e8a1c93f2d7e6k5m0p",
	"dynamicData": {
		"name": "Robert",
		"login_link": "https://app.autosend.io/login"
	}
}

​
Example Template:

Hi {{firstName}},

Welcome to AutoSend! You can log in to your account using the link below:
{{login_link}}

​
Resulting Email:

Hi Robert,

Welcome to AutoSend! You can log in to your account using the link below:
https://app.autosend.io/login

​
Supported Variable Syntax

AutoSend uses double curly braces {{variable_name}} to identify variables inside email templates.
Variable names can include letters, numbers, and underscores, but must start with a letter (e.g., {{ first_name }}, {{ orderTotal }}).

​
Using Variables in Email Templates

You can use variables anywhere in the email:
  • Subject line
  • Body text
  • Button URLs
  • Links or call-to-actions
Example: 
Subject: Welcome, {{first_name}}!

Body:
Hi {{first_name}},
Your account was created on {{signup_date}}.
Click below to verify your email:
{{verification_link}}

​
Default and Custom Variables

​
Default Variables

Some system-level variables are automatically available when sending emails through AutoSend. For example:
  • {{email}} — recipient’s email address
  • {{date}} — current date

​
Custom Variables

You can define your own custom variables when sending emails via the API. These can be anything specific to your workflow. Eg. {{order_id}}, {{invoice_amount}}, or {{reset_link}}.

​
Nested Variables

AutoSend supports nested variables, allowing you to organize your data in a more structured way. You can access nested properties using dot notation in your templates. For example, instead of flat variables like {{firstName}}, you can use nested structures like {{userData.firstName}} or {{order.id}}.

​
Example API Payload with Nested Data:

{
	"to": "[email protected]",
	"template_id": "A-c7fde221a2s3dff45cb8",
	"dynamicData": {
		"userData": {
			"firstName": "Robert",
			"lastName": "Smith",
			"email": "[email protected]"
		},
		"order": {
			"id": "#2341",
			"total": "$129.99",
			"status": "shipped"
		}
	}
}

​
Example Template with Nested Variables:

Hi {{userData.firstName}} {{userData.lastName}},

Your order {{order.id}} has been {{order.status}}!

Order Total: {{order.total}}

If you have any questions, we'll reach out to you at {{userData.email}}.

​
Resulting Email:

Hi Robert Smith,

Your order #2341 has been shipped!

Order Total: $129.99

If you have any questions, we'll reach out to you at [email protected].
Nested variables are only available with transactional emails. They are not supported in email campaigns or automation emails.

​
Using Variables with Conditions

You can use simple if/else logic in your email templates to handle missing data. For example, if a user doesn’t have a firstName, you can fall back to a default like “there”. 
Hello {{#if firstName}}{{firstName}}{{else}}there{{/if}}!

​
What this does:

  • If firstName exists → Hello Johan!
  • If it’s missing/empty → Hello there!
This works for any variable in AutoSend, just wrap it with {{#if}}{{else}}{{/if}} to make your messages feel natural even when some data is unavailable.

​
Best Practices

  • Always test your templates before sending live emails to ensure variables are replaced correctly.
  • Provide fallback values in your system in case a variable is missing (e.g., “Hi there” if {{name}} is not provided).
  • Keep variable names descriptive for better clarity and maintainability.

​
Troubleshooting

  • Check that your variable name in the API payload exactly matches the placeholder in your template.
  • Ensure that the variable is passed under the "variables" object in your API request.
  • Preview the email in your AutoSend dashboard to confirm the replacement works as expected.