API errors

Address is marked cleaned

422 · contact_cleaned

Why you got this

The address is marked cleaned: delivery to it failed repeatedly, or it was undeliverable when imported. It is not an opt-out.

What to do

Do not retry. Check the address for a typo. A corrected address is a different contact and can be added normally.

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/contact_cleaned",
  "title": "Address is marked cleaned",
  "status": 422
}

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