API errors

Malformed request

400 · malformed_request

Why you got this

The request body is not valid JSON. Nothing was parsed, so nothing was written.

What to do

Check the body serialises cleanly and that Content-Type: application/json is set. Bodies are flat JSON: {"email_address": "..."}, not {"contact": {"email_address": "..."}}.

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/malformed_request",
  "title": "Malformed request",
  "status": 400
}

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