PATCH /account
Change account settings. postal_address is the sender address printed in every broadcast footer; a broadcast is not sent until it is set. null clears it.
Parameters
Idempotency-Keyheader · string · optional — 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-Keyheader · string · optional — Alias of Idempotency-Key. Idempotency-Key wins if both are sent.
Request body
| Field | Type | Required | Notes |
|---|---|---|---|
| postal_address | string | null | yes |
Responses
200— Success400— Validation error401— Missing API key403— Forbidden404— Not found409— Conflict429— Rate limited500— Internal server error
Response headers
ratelimit-limit— Messages this API key may spend in one 60-second window.ratelimit-remaining— Messages left in the current window.ratelimit-reset— Seconds until the current window resets and the budget refills.
200 body
| Field | Type | Required | Notes |
|---|---|---|---|
| approval_reason | string | null | yes | |
| created_at | string | yes | |
| id | string | yes | |
| is_review_account | boolean | yes | |
| name | string | yes | |
| onboarding | object | yes | |
| onboarding.checklist_dismissed_at | string | null | yes | |
| onboarding.company | string | yes | |
| onboarding.completed_at | string | null | yes | |
| onboarding.connect_agent_moment_due | boolean | yes | |
| onboarding.contact_name | string | null | yes | |
| onboarding.expected_volume | "under_30k" | "30k_100k" | "100k_1m" | "over_1m" | null | yes | |
| onboarding.use_cases | array<"transactional" | "product_lifecycle" | "ai_agents"> | yes | |
| onboarding.website | string | null | yes | |
| onboarding.website_domain | string | null | yes | |
| onboarding_sender | object | null | yes | |
| postal_address | string | null | yes | |
| status | "sandboxed" | "approved" | "suspended" | yes |
Errors
The codes this operation can answer with, and what to do about each. Every one arrives with its code, message, fix and docs_url.
idempotency_in_flight(409) — A request with this Idempotency-Key is still in progress. Fix: Wait and retry with the same Idempotency-Key to receive the original response.idempotency_payload_mismatch(409) — Same Idempotency-Key was used with a different payload. Fix: Reuse the exact same body for retries, or send a new Idempotency-Key for a new request.internal_server_error(500) — Unexpected error. Fix: Retry ONCE after a short pause, with the same Idempotency-Key so the retry cannot double-send. If it fails again, stop retrying and report the x-request-id from the response — that id is what identifies this exact failure in support.invalid_idempotency_key(400) — Idempotency-Key must be 1-256 characters. Fix: Send a non-empty Idempotency-Key header of at most 256 characters.payload_too_large(413) — Request body is larger than this endpoint accepts. Fix: Send a smaller body. Most endpoints accept 1 MB. Sends (POST /emails, /emails/batch, replies) and template, broadcast and automation edits accept 50 MB, which fits 40 MB of attachments after base64. /mcp accepts 1 MB per JSON-RPC call.rate_limit_exceeded(429) — Too many requests. Fix: Back off and retry honoring the Retry-After header.unsupported_media_type(415) — This endpoint does not accept that content type. Fix: Send the body as JSON with `Content-Type: application/json`.validation_error(400) — Error in one or more fields. Fix: Correct the fields listed in the error details and retry the request.