Emails

const email = await send0.emails.send({
  from: 'Acme <hello@acme.com>',
  to: 'user@example.com',
  subject: 'Welcome to Acme!',
  html: '<h1>Welcome</h1><p>Thanks for joining.</p>',
  tags: { category: 'onboarding' },
});

email = client.emails.send(
    from_address="Acme <hello@acme.com>",
    to="user@example.com",
    subject="Welcome to Acme!",
    html="<h1>Welcome</h1><p>Thanks for joining.</p>",
    tags={"category": "onboarding"},
)

email, err := client.Emails.Send(ctx, &send0.SendEmailParams{
    From:    "Acme <hello@acme.com>",
    To:      []string{"user@example.com"},
    Subject: "Welcome to Acme!",
    HTML:    "<h1>Welcome</h1><p>Thanks for joining.</p>",
    Tags:    map[string]string{"category": "onboarding"},
})

curl -X POST https://api.send0.dev/v1/emails \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "user@example.com",
    "subject": "Welcome to Acme!",
    "html": "<h1>Welcome</h1><p>Thanks for joining.</p>",
    "tags": { "category": "onboarding" }
  }'

{
  "id": "em_2xKq9mNpLvRw",
  "object": "email",
  "status": "queued",
  "from": "Acme <hello@acme.com>",
  "to": ["user@example.com"],
  "subject": "Welcome to Acme!",
  "created_at": "2026-04-12T10:30:00Z",
  "scheduled_at": null,
  "test_mode": false
}

const email = await send0.emails.send({
  from: 'billing@acme.com',
  to: 'user@example.com',
  subject: 'Your Invoice',
  html: '<p>Please find your invoice attached.</p>',
  attachments: [
    {
      filename: 'invoice.pdf',
      content: base64EncodedContent,
      contentType: 'application/pdf',
    },
  ],
});

const email = await send0.emails.send({
  from: 'hello@acme.com',
  to: 'user@example.com',
  subject: 'Welcome!',
  template: 'tmpl_welcome123',
  data: { name: 'Jane', company: 'Acme' },
});

const email = await send0.emails.get('em_2xKq9mNpLvRw');

email = client.emails.get("em_2xKq9mNpLvRw")

email, err := client.Emails.Get(ctx, "em_2xKq9mNpLvRw")

curl https://api.send0.dev/v1/emails/em_2xKq9mNpLvRw \
  -H "Authorization: Bearer sk_live_..."

{
  "id": "em_2xKq9mNpLvRw",
  "object": "email",
  "status": "delivered",
  "from": "hello@acme.com",
  "to": ["user@example.com"],
  "cc": null,
  "bcc": null,
  "subject": "Welcome to Acme!",
  "html": "<h1>Welcome</h1>",
  "text": null,
  "tags": { "category": "onboarding" },
  "created_at": "2026-04-12T10:30:00Z",
  "scheduled_at": null,
  "sent_at": "2026-04-12T10:30:01Z",
  "delivered_at": "2026-04-12T10:30:03Z",
  "opened_at": "2026-04-12T10:35:00Z",
  "test_mode": false
}

const { data, has_more, cursor } = await send0.emails.list({
  limit: 20,
  status: 'delivered',
});

result = client.emails.list(limit=20, status="delivered")
for email in result.data:
    print(email.id, email.status)

list, err := client.Emails.List(ctx, &send0.ListEmailsParams{
    Limit:  20,
    Status: "delivered",
})
for _, email := range list.Data {
    fmt.Println(email.ID, email.Status)
}

curl "https://api.send0.dev/v1/emails?limit=20&status=delivered" \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [...],
  "has_more": true,
  "cursor": "cur_abc123"
}

await send0.emails.cancel('em_2xKq9mNpLvRw');

client.emails.cancel("em_2xKq9mNpLvRw")

err := client.Emails.Cancel(ctx, "em_2xKq9mNpLvRw")

curl -X DELETE https://api.send0.dev/v1/emails/em_2xKq9mNpLvRw \
  -H "Authorization: Bearer sk_live_..."

const batch = await send0.emails.batch({
  from: 'hello@acme.com',
  subject: 'Monthly Update',
  template: 'tmpl_monthly',
  recipients: [
    { to: 'jane@example.com', variables: { name: 'Jane' } },
    { to: 'john@example.com', variables: { name: 'John' } },
  ],
});

console.log(batch.count); // 2
console.log(batch.emails[0].id); // em_xxxx

batch = client.emails.batch(
    from_address="hello@acme.com",
    subject="Monthly Update",
    template="tmpl_monthly",
    recipients=[
        {"to": "jane@example.com", "variables": {"name": "Jane"}},
        {"to": "john@example.com", "variables": {"name": "John"}},
    ],
)
print(batch.count)  # 2

batch, err := client.Emails.Batch(ctx, &send0.SendBatchParams{
    From:     "hello@acme.com",
    Subject:  "Monthly Update",
    Template: "tmpl_monthly",
    Recipients: []send0.BatchRecipient{
        {To: []string{"jane@example.com"}, Variables: map[string]any{"name": "Jane"}},
        {To: []string{"john@example.com"}, Variables: map[string]any{"name": "John"}},
    },
})
fmt.Println(batch.Count) // 2

curl -X POST https://api.send0.dev/v1/emails/batch \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@acme.com",
    "subject": "Monthly Update",
    "template": "tmpl_monthly",
    "recipients": [
      { "to": "jane@example.com", "variables": { "name": "Jane" } },
      { "to": "john@example.com", "variables": { "name": "John" } }
    ]
  }'

{
  "object": "email.batch",
  "id": "batch_2xKq9mNpLvRw",
  "count": 2,
  "emails": [
    {
      "id": "em_abc123",
      "object": "email",
      "status": "queued",
      "from": "hello@acme.com",
      "to": ["jane@example.com"],
      "subject": "Monthly Update",
      "created_at": "2026-04-12T10:30:00Z",
      "batch_id": "batch_2xKq9mNpLvRw"
    },
    {
      "id": "em_def456",
      "object": "email",
      "status": "queued",
      "from": "hello@acme.com",
      "to": ["john@example.com"],
      "subject": "Monthly Update",
      "created_at": "2026-04-12T10:30:00Z",
      "batch_id": "batch_2xKq9mNpLvRw"
    }
  ]
}