# Authentication (/docs/authentication)

Create a key in the dashboard and send it as a Bearer token.

Every request sends your key in the `Authorization` header:

```http
Authorization: Bearer gm_live_...
```

This header is the only place the API reads the key.
A key in a query string or a cookie does not authenticate.

## Create a key [#create-a-key]

1. Sign in to GetMattered.
2. Open [Developers](https://getmattered.com/dashboard/developers) in the dashboard.
3. Choose **Create key** and give it a name, like `Production`.
4. Copy the key. We show it once.

We store only a hash of the key, so we cannot show it to you again.
We email you each time a key is created on your account.

Create and manage your keys at https://getmattered.com/dashboard/developers.

## Keys [#keys]

- A key starts with `gm_live_`.
- A key acts as you. Its calls spend your API tokens, and its applications go out from your account.
- A key sends applications only if you ticked **Can send applications** when you made it. See [Key scopes](/docs/key-scopes).
- An account can have up to 5 active keys. Revoke one to create another.
- Each key has its own per-minute rate limit. See [Rate limits](/docs/rate-limits).
- The dashboard and your usage report list each key by its name and its first characters, like `gm_live_AbCd`.

Keep keys on your server.
Never put a key in browser code, a mobile app or a public repository.

## Revoke a key [#revoke-a-key]

Open [Developers](https://getmattered.com/dashboard/developers) and choose **Revoke** next to the key.
The key stops working at once, on its next call.
A revoked key never comes back. Create a new one to replace it.

## Enterprise volume [#enterprise-volume]

Need more than self-serve, such as high volume, applications for your own candidates or custom terms?
Send the enterprise form in the same [Developers](https://getmattered.com/dashboard/developers) section.
We reply by email.

## When authentication fails [#when-authentication-fails]

A missing, malformed, unknown or revoked key gets `401` with the code `UNAUTHORIZED`:

```json
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key. Send it as `Authorization: Bearer gm_live_...`.",
    "context": { "errorType": "authentication", "failureReason": "missing_token" }
  },
  "meta": { "timestamp": "2026-11-18T12:00:00.000Z", "version": "v1" }
}
```

A refused call runs no work and spends no tokens.