> ## Documentation Index
> Fetch the complete documentation index at: https://resend.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Send Email
> Trigger templated emails in your Automations.
This automation step triggers a [Template](/dashboard/templates/introduction) email to be sent to the contact.
## How it works
After adding a [trigger](/dashboard/automations/trigger), create a new step to **Send an email**.
Select a published template, then configure the subject and sender address.
Add a `send_email` step to your Automation's `steps` array.
```ts Node.js {13-21} theme={"theme":{"light":"github-light","dark":"vesper"}}
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.automations.create({
name: 'Welcome series',
steps: [
{
key: 'start',
type: 'trigger',
config: { eventName: 'user.created' },
},
{
key: 'welcome',
type: 'send_email',
config: {
template: {
id: '044db673-fff6-420f-a566-f6aba05d60e7',
},
},
},
],
connections: [{ from: 'start', to: 'welcome' }],
});
```
```php PHP {11-19} theme={"theme":{"light":"github-light","dark":"vesper"}}
$resend = Resend::client('re_xxxxxxxxx');
$resend->automations->create([
'name' => 'Welcome series',
'steps' => [
[
'key' => 'start',
'type' => 'trigger',
'config' => ['event_name' => 'user.created'],
],
[
'key' => 'welcome',
'type' => 'send_email',
'config' => [
'template' => [
'id' => '044db673-fff6-420f-a566-f6aba05d60e7',
],
],
],
],
'connections' => [['from' => 'start', 'to' => 'welcome']],
]);
```
```python Python {13-21} theme={"theme":{"light":"github-light","dark":"vesper"}}
import resend
resend.api_key = "re_xxxxxxxxx"
params: resend.Automations.CreateParams = {
"name": "Welcome series",
"steps": [
{
"key": "start",
"type": "trigger",
"config": {"event_name": "user.created"},
},
{
"key": "welcome",
"type": "send_email",
"config": {
"template": {
"id": "044db673-fff6-420f-a566-f6aba05d60e7",
},
},
},
],
"connections": [{"from": "start", "to": "welcome"}],
}
resend.Automations.create(params)
```
```ruby Ruby {13-21} theme={"theme":{"light":"github-light","dark":"vesper"}}
require "resend"
Resend.api_key = "re_xxxxxxxxx"
params = {
name: "Welcome series",
steps: [
{
key: "start",
type: "trigger",
config: { event_name: "user.created" },
},
{
key: "welcome",
type: "send_email",
config: {
template: {
id: "044db673-fff6-420f-a566-f6aba05d60e7",
},
},
},
],
connections: [{ from: "start", to: "welcome" }],
}
Resend::Automations.create(params)
```
```go Go {18-26} theme={"theme":{"light":"github-light","dark":"vesper"}}
package main
import "github.com/resend/resend-go/v3"
func main() {
client := resend.NewClient("re_xxxxxxxxx")
params := &resend.CreateAutomationRequest{
Name: "Welcome series",
Steps: []resend.AutomationStep{
{
Key: "start",
Type: resend.AutomationStepTypeTrigger,
Config: map[string]any{
"event_name": "user.created",
},
},
{
Key: "welcome",
Type: resend.AutomationStepTypeSendEmail,
Config: map[string]any{
"template": map[string]any{
"id": "044db673-fff6-420f-a566-f6aba05d60e7",
},
},
},
},
Connections: []resend.AutomationConnection{
{From: "start", To: "welcome"},
},
}
client.Automations.Create(params)
}
```
```rust Rust {22-27} theme={"theme":{"light":"github-light","dark":"vesper"}}
use resend_rs::{
types::{
AutomationStatus, AutomationTemplate, Connection, CreateAutomationOptions, SendEmailStepConfig,
Step, TriggerStepConfig,
},
Resend, Result,
};
#[tokio::main]
async fn main() -> Result<()> {
let resend = Resend::new("re_xxxxxxxxx");
let opts = CreateAutomationOptions {
name: "Welcome series".to_owned(),
steps: vec![
Step::Trigger {
key: "start".to_owned(),
config: TriggerStepConfig {
event_name: "user.created".to_owned(),
},
},
Step::SendEmail {
key: "welcome".to_owned(),
config: SendEmailStepConfig::new(AutomationTemplate::new(
"044db673-fff6-420f-a566-f6aba05d60e7",
)),
},
],
connections: vec![Connection::new("start", "welcome")],
status: AutomationStatus::Disabled,
};
let _automation = resend.automations.create(opts).await?;
Ok(())
}
```
```java Java {15-23} theme={"theme":{"light":"github-light","dark":"vesper"}}
import com.resend.*;
public class Main {
public static void main(String[] args) {
Resend resend = new Resend("re_xxxxxxxxx");
CreateAutomationOptions options = CreateAutomationOptions.builder()
.name("Welcome series")
.steps(
AutomationStep.trigger("start")
.eventName("user.created")
.build(),
AutomationStep.sendEmail("welcome")
.template("044db673-fff6-420f-a566-f6aba05d60e7")
.templateVariable("name", Map.of("var", "event.firstName"))
.build()
)
.connections(
AutomationConnection.builder()
.from("start")
.to("welcome")
.build()
)
.build();
CreateAutomationResponseSuccess data = resend.automations().create(options);
}
}
```
```csharp .NET {7-14,22} theme={"theme":{"light":"github-light","dark":"vesper"}}
using Resend;
using System.Text.Json;
IResend resend = ResendClient.Create( "re_xxxxxxxxx" );
var startConfig = JsonSerializer.SerializeToElement( new { event_name = "user.created" } );
var welcomeConfig = JsonSerializer.SerializeToElement( new
{
template = new
{
id = "044db673-fff6-420f-a566-f6aba05d60e7",
variables = new { name = new { @var = "event.firstName" } },
},
subject = "Welcome to Acme!",
from = "Acme ",
reply_to = "support@example.com",
} );
var resp = await resend.AutomationCreateAsync( new AutomationCreateData()
{
Name = "Welcome series",
Steps = new List
{
new AutomationStepData { Ref = "start", Type = "trigger", Config = startConfig },
new AutomationStepData { Ref = "welcome", Type = "send_email", Config = welcomeConfig },
},
Connections = new List
{
new AutomationEdge { From = "start", To = "welcome", EdgeType = "default" },
},
} );
```
```bash cURL {10-17} theme={"theme":{"light":"github-light","dark":"vesper"}}
curl -X POST 'https://api.resend.com/automations' \
-H 'Authorization: Bearer re_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d '{
"name": "Welcome series",
"steps": [{
"key": "start",
"type": "trigger",
"config": { "event_name": "user.created" }
}, {
"key": "welcome",
"type": "send_email",
"config": {
"template": {
"id": "044db673-fff6-420f-a566-f6aba05d60e7"
}
}
}],
"connections": [
{ "from": "start", "to": "welcome" }
]
}'
```
```bash CLI theme={"theme":{"light":"github-light","dark":"vesper"}}
resend automations create --name "Welcome series" --file ./automation.json
```
Only `published` templates are available to be used in an Automation.
## Template variables
Use the `variables` field to pass data into your template. Each variable value can be a dynamic reference or a static string.
| Type | Format | Description |
| ----------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Event data | `{ "var": "event." }` | Resolves a field from the triggering event's payload. |
| Contact data | `{ "var": "contact." }` | Resolves a field from the contact record. |
| Waited event data | `{ "var": "wait_events.." }` | Resolves a field from a preceding [wait for event](/dashboard/automations/wait-for-event) step's payload. |
| Static value | `""` | Passed as-is to the template. |
```json {7-14} theme={"theme":{"light":"github-light","dark":"vesper"}}
{
"key": "welcome",
"type": "send_email",
"config": {
"template": {
"id": "044db673-fff6-420f-a566-f6aba05d60e7",
"variables": {
"firstName": { "var": "event.firstName" },
"orderNumber": { "var": "event.orderId" },
"total": { "var": "event.amount" },
"company": { "var": "contact.properties.company" },
"feedback": { "var": "wait_events.feedback.received.response" },
"supportEmail": "help@example.com"
}
}
}
}
```
If the same branch has multiple [wait for
event](/dashboard/automations/wait-for-event) steps with the same key, the
resolved data will come from the last event received before the current step.
Template variables must be present in your referenced template and the key names must match exactly with the template variable names.
For more help working with variables, see the [Template documentation](/dashboard/templates/template-variables).
## Configuration
The published template to send. Provide `id` and optionally `variables`.
The ID or alias of the template to send.
A key-value map of template variables. Each value can be a static string or a variable reference object (`{ "var": "event.fieldName" }`) that resolves dynamically from the `event.*`, `contact.*`, or `wait_events.*` namespaces.
The sender email address.
If provided, this value will override the template's default value.
The email subject line.
If provided, this value will override the template's default value.
Reply-to email address.
If provided, this value will override the template's default value.
```json theme={"theme":{"light":"github-light","dark":"vesper"}}
{
"key": "welcome",
"type": "send_email",
"config": {
"template": {
"id": "062f8ef4-fbfa-44f1-b5e0-ff8e1e8ffa96",
"variables": {
"name": { "var": "event.firstName" }
}
},
"from": "hello@example.com",
"subject": "Welcome!",
"reply_to": "support@example.com"
}
}
```