emails

Send up to 500 emails.

Each item succeeds or fails on its own — read data[i].status. x-batch-validation: strict (all or none) or permissive (ids and errors).

post/emails/batch

Request

  • Base URL: https://api.agentisend.com
  • URL: https://api.agentisend.com/emails/batch
  • 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

Changes

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