> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corsair.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Credentials

> Step-by-step instructions for obtaining Sentry auth tokens and webhook secrets for the Corsair Sentry plugin.

This guide walks you through obtaining all required credentials for the Sentry plugin.

## Authentication Method

The Sentry plugin uses API key authentication.

* **[`api_key`](/concepts/api-key)** (default) — Sentry **User auth token** (sent as `Authorization: Bearer <token>` to `https://sentry.io/api/0/`)

Sentry’s API expects a bearer token with sufficient scopes for the endpoints you use (organizations, projects, issues, releases, etc.).

## User Auth Token

### Step 1: Create a Token

1. Log in to [Sentry](https://sentry.io/).
2. Open **Settings** → **Account** → **Auth Tokens** (or **User settings** → **Auth Tokens**).
3. Click **Create New Token**.
4. Name the token (for example, `Corsair`) and select **scopes** that match your needs — at minimum, the read/write scopes for organizations, projects, issues, or releases you will access via Corsair.
5. Create the token and **copy it immediately**.

**Storing credentials:**

```bash theme={null}
pnpm corsair setup --plugin=sentry api_key=your-auth-token
```

Verify:

```bash theme={null}
pnpm corsair auth --plugin=sentry --credentials
```

If you self-host Sentry, generate tokens from your instance’s account settings the same way; Corsair still sends the value as a Bearer token to your configured API base where applicable.

## Webhook Secret

Sentry integrations that deliver webhooks to your app may include a secret for verifying `sentry-hook-signature` (or related headers).

1. In Sentry, open **Settings** → **Integrations** (or your **Internal integration**) for the project or organization.
2. Configure the outbound webhook and copy the **secret** used for signature verification.

**Storing credentials:**

```bash theme={null}
pnpm corsair setup --plugin=sentry webhook_signature=your-webhook-secret
```

## Required Credentials Summary

| Credential      | Required for                        | Where to find                       |
| --------------- | ----------------------------------- | ----------------------------------- |
| User auth token | [`api_key`](/concepts/api-key) auth | Sentry → Settings → Auth Tokens     |
| Webhook secret  | Webhooks                            | Integration / webhook configuration |

For general information about how Corsair handles authentication, see [Authentication](/concepts/auth).