# Sentry: credentials

You connect your Sentry account to your organization either through OAuth for Sentry Cloud or with an API token, which also works for a self-hosted instance.

> Source: https://www.application-platform.com/en/docs/sentry-credentials/

Under **Connections** you connect the Sentry account in which the platform creates the Sentry projects for your components. **Connect with Sentry** uses a Public Integration and works only with Sentry Cloud at [sentry.io](https://sentry.io). **Add API token** also works with a self-hosted instance; you provide the host, the organization slug, and an auth token.

## Creating an auth token in Sentry

1. Sign in at [sentry.io](https://sentry.io) or at your own instance and open your organization.
2. Go to **Settings → Account → API → Auth Tokens**. Organization tokens live under **Settings → Developer Settings / Auth Tokens**; the labels may differ depending on your Sentry version.
3. Create a token with these scopes:
   - `org:read` to read the organization
   - `project:read` and `project:write` for projects and client keys
   - `team:read` and `team:write`, because the platform creates a team if needed
4. Copy the token. Sentry shows it only once.

On a self-hosted instance such as `https://sentry.example.com` the procedure is the same. Grant only the scopes listed above rather than a broad admin token, and update the entry under **Connections** after regenerating the token in Sentry.

## Entering the token in the platform

Open **Connections → Sentry → Add API token** and fill in the fields.

| Field | Content |
|---|---|
| **Name** and **Slug** | Display name and immutable slug for the projects |
| **Instance** | **Sentry Cloud (sentry.io)** or **Self-hosted** |
| **Sentry URL** | Self-hosted only: the base URL of your instance without `/api/0` |
| **Organization (slug)** | The organization slug from the Sentry URL, for example `my-company` |
| **Auth token** | The token you created in Sentry |

After saving, the connection is available for selection in your organization's projects. [Error tracking]({{< relref "error-tracking" >}}) describes how to enable Sentry for a component.

## OAuth for Sentry Cloud

Under **Connections → Sentry**, choose **Connect with Sentry** and sign in. This option is not available for self-hosted instances.