emails

Send an email.

Returns the message id; delivery happens on the queue. Before a domain is verified, from onboarding@agentisend.com delivers only to this account's member sign-in addresses (20 per UTC day, no cc/bcc/attachments/tracking/extra headers). Addresses ending in @simulator.agentisend.com cost nothing and reach nobody.

post/emails

Request

  • Base URL: https://api.agentisend.com
  • URL: https://api.agentisend.com/emails
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Makes this call safe to retry. Send the same key with the same body and the original response is replayed instead of the work happening twice. Keys are 1-256 characters and are remembered for 7 days. While the first attempt is still running, a second call with that key returns 409 idempotency_in_flight (Resend calls this concurrent_idempotent_requests); the same key with a different body returns 409 idempotency_payload_mismatch (Resend: invalid_idempotent_request). Resend-Idempotency-Key is accepted as the same header.

Resend-Idempotency-Keystring

Alias of Idempotency-Key. Idempotency-Key wins if both are sent.

Request body

fromstring

Sender. A verified domain, or the onboarding address while a domain is still pending. Optional only when the template has a default sender; a from here overrides it.

subjectstring

Required unless template or template_id names a published template that has a subject. Overrides the template subject when both exist.

htmlstring

HTML body. Provide html, text, or a template.

textstring

Plain-text body. Provide html, text, or a template.

headersobject

Extra headers. Names that this API sets itself are replaced.

scheduled_atstring

ISO 8601 or a short phrase ("in 1 hour", "tomorrow 9am"). Max 30 days ahead.

scheduledAtstring

Resend Node SDK name for scheduled_at.

timezonestring

Time zone for a scheduled_at phrase such as "tomorrow 9am". An ISO time ignores this. Example: America/Los_Angeles. Omitted phrases are read in UTC.

topic_idstring uuid

Subscription topic. Recipients who opted out of it are not sent this message.

topicIdstring uuid

Resend Node SDK name for topic_id.

template_idstring

Id or alias of the published template to render, instead of html or text.

template_valuesobject

Values for the template placeholders.

expires_atstring date-time

When a held send stops waiting for a person. At most 7 days ahead. Ignored when the send is not held.

Response

Success

idstring uuid required
simulatedboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.