API errors

Something went wrong on our end

500 · server_error

Why you got this

A problem on our side. The request may or may not have been applied, so treat the outcome as unknown.

What to do

Retry once with the same request. Writes are keyed by the values you send, so a repeat cannot create a duplicate. If it persists, get in touch rather than working around it.

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/server_error",
  "title": "Something went wrong on our end",
  "status": 500
}

Every code

• account_closing — Account is closing
• confirmation_unavailable — Confirmation email cannot be sent
• contact_cleaned — Address is marked cleaned
• 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
• suppressed_cannot_resubscribe — Address cannot be resubscribed
• validation_failed — Validation failed

Back to the API reference