API errors

Invalid or missing API key

401 · invalid_api_key

Why you got this

The request carried no Authorization: Bearer <token> header, or a token that matches no key. Revoked keys answer here too.

What to do

Check the header reads Authorization: Bearer emf_live_... with no extra whitespace. A key is shown once when it is created and cannot be retrieved later, so if yours is lost, create a new one in Settings → API keys and revoke the old. Retrying will not help.

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/invalid_api_key",
  "title": "Invalid or missing API key",
  "status": 401
}

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