Send an email

POST/emailsSend an email

Parameters

Idempotency-Keystringheader

A unique identifier for the request to ensure emails are only sent once. [Learn more](https://resend.com/docs/dashboard/emails/idempotency-keys)

maxLength 256

Request body

application/json

objectSendEmailRequest

attachmentsarray of object

Show child attributes

Show array items

contentstring · binary

Content of an attached file.

content_idstring

Content ID for embedding inline images using cid references (e.g., cid:image001).

content_typestring

Optional content type for the attachment, if not set it will be derived from the filename property

filenamestring

Name of attached file.

pathstring

Path where the attachment file is hosted

bccvalue

Bcc recipient email address. For multiple addresses, send as an array of strings.

Show child attributes

oneOf · 2 options

Option 1string

Option 2array of string

ccvalue

Cc recipient email address. For multiple addresses, send as an array of strings.

Show child attributes

oneOf · 2 options

Option 1string

Option 2array of string

fromstringrequired

Sender email address. To include a friendly name, use the format "Your Name <sender@domain.com>".

headersobject

Custom headers to add to the email.

htmlstring

The HTML version of the message.

reply_tovalue

Reply-to email address. For multiple addresses, send as an array of strings.

Show child attributes

oneOf · 2 options

Option 1string

Option 2array of string

scheduled_atstring

Schedule email to be sent later. The date should be in ISO 8601 format.

subjectstringrequired

Email subject.

tagsarray of object

Show child attributes

Show array items

namestring

The name of the email tag. It can only contain ASCII letters (a–z, A–Z), numbers (0–9), underscores (_), or dashes (-). It can contain no more than 256 characters.

valuestring

The value of the email tag.It can only contain ASCII letters (a–z, A–Z), numbers (0–9), underscores (_), or dashes (-). It can contain no more than 256 characters.

templatevalue

Show child attributes

allOf · 2 options

Option 1objectEmailTemplateInput

idstringrequired

The id of the published email template.

variablesobject

Template variables object with key/value pairs.

Option 2value

Use a published template to send the email. If provided, do not include html or text.

textstring

The plain text version of the message.

tovaluerequired

Recipient email address. For multiple addresses, send as an array of strings. Max 50.

Show child attributes

oneOf · 2 options

Option 1string

Option 2array of string

maxItems 50 · minItems 1

topic_idstring

The topic ID to scope the email to. If the recipient is a contact and opted-in to the topic, the email is sent. If opted-out, the email is not sent. If the recipient is not a contact, the email is sent if the topic's default subscription is opt_in.

Example request

{
  "attachments": [
    {
      "content": "binary",
      "content_id": "string",
      "content_type": "string",
      "filename": "string",
      "path": "string"
    }
  ],
  "bcc": "string",
  "cc": "string",
  "from": "string",
  "headers": {},
  "html": "string",
  "reply_to": "string",
  "scheduled_at": "string",
  "subject": "string",
  "tags": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "template": {
    "id": "string",
    "variables": {
      "variableName": "Sign up now",
      "variableName2": 123
    }
  },
  "text": "string",
  "to": "string",
  "topic_id": "string"
}

Responses

objectSendEmailResponse

idstring

The ID of the sent email.

Example response

{
  "id": "string"
}

Examples

Idempotency-Keyheader parameter

curl -X POST 'https://api.resend.com/emails' \
  -H 'Content-Type: application/json' \
  -d '{"attachments":[{"content":"binary","content_id":"string","content_type":"string","filename":"string","path":"string"}],"bcc":"string","cc":"string","from":"string","headers":{},"html":"string","reply_to":"string","scheduled_at":"string","subject":"string","tags":[{"name":"string","value":"string"}],"template":{"id":"string","variables":{"variableName":"Sign up now","variableName2":123}},"text":"string","to":"string","topic_id":"string"}'

const response = await fetch('https://api.resend.com/emails', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"attachments":[{"content":"binary","content_id":"string","content_type":"string","filename":"string","path":"string"}],"bcc":"string","cc":"string","from":"string","headers":{},"html":"string","reply_to":"string","scheduled_at":"string","subject":"string","tags":[{"name":"string","value":"string"}],"template":{"id":"string","variables":{"variableName":"Sign up now","variableName2":123}},"text":"string","to":"string","topic_id":"string"}),
});
const data = await response.json();

const response = await fetch('https://api.resend.com/emails', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: "{\"attachments\":[{\"content\":\"binary\",\"content_id\":\"string\",\"content_type\":\"string\",\"filename\":\"string\",\"path\":\"string\"}],\"bcc\":\"string\",\"cc\":\"string\",\"from\":\"string\",\"headers\":{},\"html\":\"string\",\"reply_to\":\"string\",\"scheduled_at\":\"string\",\"subject\":\"string\",\"tags\":[{\"name\":\"string\",\"value\":\"string\"}],\"template\":{\"id\":\"string\",\"variables\":{\"variableName\":\"Sign up now\",\"variableName2\":123}},\"text\":\"string\",\"to\":\"string\",\"topic_id\":\"string\"}" });
console.log(await response.json());

import requests

response = requests.request(
    "POST",
    "https://api.resend.com/emails",
    headers={"Content-Type": "application/json"},
    data='{"attachments":[{"content":"binary","content_id":"string","content_type":"string","filename":"string","path":"string"}],"bcc":"string","cc":"string","from":"string","headers":{},"html":"string","reply_to":"string","scheduled_at":"string","subject":"string","tags":[{"name":"string","value":"string"}],"template":{"id":"string","variables":{"variableName":"Sign up now","variableName2":123}},"text":"string","to":"string","topic_id":"string"}',
)
print(response.json())

package main

import (
	"context"
	"net/http"
	"strings"
)

func main() {
	ctx := context.Background()
	body := strings.NewReader(`{"attachments":[{"content":"binary","content_id":"string","content_type":"string","filename":"string","path":"string"}],"bcc":"string","cc":"string","from":"string","headers":{},"html":"string","reply_to":"string","scheduled_at":"string","subject":"string","tags":[{"name":"string","value":"string"}],"template":{"id":"string","variables":{"variableName":"Sign up now","variableName2":123}},"text":"string","to":"string","topic_id":"string"}`)
	req, err := http.NewRequestWithContext(ctx, "POST", "https://api.resend.com/emails", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

<?php
$request = curl_init("https://api.resend.com/emails");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($request, CURLOPT_POSTFIELDS, "{\"attachments\":[{\"content\":\"binary\",\"content_id\":\"string\",\"content_type\":\"string\",\"filename\":\"string\",\"path\":\"string\"}],\"bcc\":\"string\",\"cc\":\"string\",\"from\":\"string\",\"headers\":{},\"html\":\"string\",\"reply_to\":\"string\",\"scheduled_at\":\"string\",\"subject\":\"string\",\"tags\":[{\"name\":\"string\",\"value\":\"string\"}],\"template\":{\"id\":\"string\",\"variables\":{\"variableName\":\"Sign up now\",\"variableName2\":123}},\"text\":\"string\",\"to\":\"string\",\"topic_id\":\"string\"}");
curl_setopt($request, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://api.resend.com/emails"))
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"attachments\":[{\"content\":\"binary\",\"content_id\":\"string\",\"content_type\":\"string\",\"filename\":\"string\",\"path\":\"string\"}],\"bcc\":\"string\",\"cc\":\"string\",\"from\":\"string\",\"headers\":{},\"html\":\"string\",\"reply_to\":\"string\",\"scheduled_at\":\"string\",\"subject\":\"string\",\"tags\":[{\"name\":\"string\",\"value\":\"string\"}],\"template\":{\"id\":\"string\",\"variables\":{\"variableName\":\"Sign up now\",\"variableName2\":123}},\"text\":\"string\",\"to\":\"string\",\"topic_id\":\"string\"}"))
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://api.resend.com/emails")
request = Net::HTTPGenericRequest.new("POST", true, true, uri)
request['Content-Type'] = 'application/json'
request.body = "{\"attachments\":[{\"content\":\"binary\",\"content_id\":\"string\",\"content_type\":\"string\",\"filename\":\"string\",\"path\":\"string\"}],\"bcc\":\"string\",\"cc\":\"string\",\"from\":\"string\",\"headers\":{},\"html\":\"string\",\"reply_to\":\"string\",\"scheduled_at\":\"string\",\"subject\":\"string\",\"tags\":[{\"name\":\"string\",\"value\":\"string\"}],\"template\":{\"id\":\"string\",\"variables\":{\"variableName\":\"Sign up now\",\"variableName2\":123}},\"text\":\"string\",\"to\":\"string\",\"topic_id\":\"string\"}"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://api.resend.com/emails");
request.Content = new StringContent("{\"attachments\":[{\"content\":\"binary\",\"content_id\":\"string\",\"content_type\":\"string\",\"filename\":\"string\",\"path\":\"string\"}],\"bcc\":\"string\",\"cc\":\"string\",\"from\":\"string\",\"headers\":{},\"html\":\"string\",\"reply_to\":\"string\",\"scheduled_at\":\"string\",\"subject\":\"string\",\"tags\":[{\"name\":\"string\",\"value\":\"string\"}],\"template\":{\"id\":\"string\",\"variables\":{\"variableName\":\"Sign up now\",\"variableName2\":123}},\"text\":\"string\",\"to\":\"string\",\"topic_id\":\"string\"}", Encoding.UTF8, "application/json");
using var response = await client.SendAsync(request);

{
  "id": "string"
}

Search documentation

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys

Parameters

Request body

Responses

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys