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. 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
- Sign in at sentry.io or at your own instance and open your organization.
- 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.
- Create a token with these scopes:
org:readto read the organizationproject:readandproject:writefor projects and client keysteam:readandteam:write, because the platform creates a team if needed
- 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 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.