UNAUTHENTICATED

No valid API key was sent

The Authorization header is missing, malformed, or carries a key that does not exist or was revoked.

http status: 401
credits: Nothing is billed for a failed request.

What it means

Every endpoint under /api/v1 except the browser endpoint and the bounce webhooks authenticates with a secret key sent as a bearer token: Authorization: Bearer sk_live_… . Keys are shown once at creation and stored hashed, so a key you cannot find cannot be recovered.

Revoking a key from the dashboard stops its requests immediately with this code.

What to do

Send the header exactly as Authorization: Bearer followed by the key. If the key is lost, create a new one on the API keys page and retire the old one.

Example response

{
    "success": false,
    "error": {
        "code": "UNAUTHENTICATED",
        "message": "Provide a valid API key as a bearer token.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}

Every error carries the request_id also sent in the X-Request-Id header; quote it when writing to support.

markdown version: /docs/errors/UNAUTHENTICATED.md

UNAUTHENTICATED

What it means

What to do

Example response

Related