POST /webhooks/{id}/replay

Parameters

• id path · string · required
• since query · string · optional
• until query · string · optional
• event_type query · "email.queued" | "email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | … · optional
• event_id query · string · optional
• dry_run query · string | string | boolean · optional
• Idempotency-Key header · 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).

Responses

• 201 — Success
• 400 — Validation error
• 401 — Missing API key
• 403 — Forbidden
• 404 — Not found
• 409 — Conflict
• 429 — Rate limited
• 500 — 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.

Errors

Codes in the catalogue that answer with one of this operation’s error statuses. Every one of them carries a fix.

• validation_error 400
• invalid_idempotency_key 400
• invalid_cursor 400
• domain_already_exists 409
• domain_verified_elsewhere 409
• domain_not_verified 403
• account_suspended 403
• account_sandboxed 403
• trust_throttled 429
• missing_api_key 401
• session_required 401
• human_action_required 403
• csrf_origin_rejected 403
• mfa_required 401
• plan_not_purchasable 400
• trial_already_used 409
• plan_already_active 409
• term_not_on_sale 409
• subscription_active 409
• billing_customer_missing 404
• stripe_signature_invalid 400
• invalid_api_key 403
• restricted_api_key 403
• insufficient_role 403
• invite_email_mismatch 403
• already_in_account 409
• domain_scope_violation 403
• not_found 404
• session_expired 404
• idempotency_in_flight 409
• idempotency_payload_mismatch 409
• rate_ceiling_exceeded 429
• daily_quota_exceeded 429
• monthly_quota_exceeded 429
• rate_limit_exceeded 429
• approval_required 403
• trust_paused 403
• kill_switch_active 403
• internal_server_error 500
• support_ticket_not_found 404
• support_closed 409
• support_reopen_expired 409
• support_merge_conflict 409
• support_upload_rejected 400
• support_rate_limited 429