API errors

Confirmation email cannot be sent

422 · confirmation_unavailable

Why you got this

This signup needs a confirmation email, because the list asks new members to confirm or the person unsubscribed or was deleted before. The account's from address is not on a verified sending domain, so that email cannot go out.

What to do

The account owner needs to verify a sending domain in Settings and set a from address on it, so pass this on to them. Safe to retry once it is done.

How it arrives

Every failure on the API is an RFC 7807 problem document, sent asapplication/problem+json. Branch on type — or on its last segment, which is the code above — rather than ontitle or detail, which are prose and may be reworded.

{
  "type": "https://emailfig.com/docs/errors/confirmation_unavailable",
  "title": "Confirmation email cannot be sent",
  "status": 422
}

Every code

• account_closing — Account is closing
• account_suspended — Account is suspended
• address_unmailable — Address cannot be emailed
• confirmation_unavailable — Confirmation email cannot be sent
• endpoint_disabled — Webhook endpoint is off
• invalid_api_key — Invalid or missing API key
• malformed_request — Malformed request
• not_found — Not found
• rate_limited — Rate limit exceeded
• server_error — Something went wrong on our end
• validation_failed — Validation failed

Back to the API reference