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

# Sentry (Public Integrations)

## Overview

<CardGroup cols={3}>
  <Card title="Pre-built tooling" icon="screwdriver-wrench" href="#pre-built-tooling" />

  <Card title="Pre-built integrations" icon="square-check" href="#pre-built-integrations" />

  <Card title="Access requirements" icon="triangle-exclamation" href="#access-requirements" />

  <Card title="Setup guide" icon="rocket" href="#setup-guide" />

  <Card title="Useful links" icon="circle-info" href="#useful-links" />

  <Card title="API gotchas" icon="biohazard" href="#api-gotchas" />
</CardGroup>

## Pre-built tooling

<AccordionGroup>
  <Accordion title="✅ Authorization">
    | Tools                           | Status |
    | ------------------------------- | ------ |
    | Pre-built authorization (OAuth) | ✅      |
    | Credentials auto-refresh        | ✅      |
    | Pre-built authorization UI      | ✅      |
    | Custom authorization UI         | ✅      |
    | End-user authorization guide    | ✅      |
    | Expired credentials detection   | ✅      |
  </Accordion>

  <Accordion title="✅ Read & write data">
    | Tools                                     | Status                         |
    | ----------------------------------------- | ------------------------------ |
    | Pre-built integrations                    | 🚫 (time to contribute: \<48h) |
    | API unification                           | ✅                              |
    | 2-way sync                                | ✅                              |
    | Webhooks from Nango on data modifications | ✅                              |
    | Real-time webhooks from 3rd-party API     | ✅                              |
    | Proxy requests                            | ✅                              |
  </Accordion>

  <Accordion title="✅ Observability & data quality">
    | Tools                   | Status |
    | ----------------------- | ------ |
    | HTTP request logging    | ✅      |
    | End-to-end type safety  | ✅      |
    | Data runtime validation | ✅      |
    | OpenTelemetry export    | ✅      |
    | Slack alerts on errors  | ✅      |
    | Integration status API  | ✅      |
  </Accordion>

  <Accordion title="✅ Customization">
    | Tools                              | Status                         |
    | ---------------------------------- | ------------------------------ |
    | Create or customize use-cases      | ✅                              |
    | Pre-configured pagination          | 🚫 (time to contribute: \<48h) |
    | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
    | Per-customer configurations        | ✅                              |
  </Accordion>
</AccordionGroup>

*No pre-built syncs or actions available yet.*

<Tip>Not seeing the integration you need? [Build your own](/guides/functions/functions-guide) independently.</Tip>

## Access requirements

| Pre-Requisites    | Status                   | Comment                                              |
| ----------------- | ------------------------ | ---------------------------------------------------- |
| Paid dev account  | ✅ Not required           | Free, self-signup [here](https://sentry.io/signup/). |
| Paid test account | ✅ Not required           | Free, self-signup [here](https://sentry.io/signup/). |
| Partnership       | ✅ Not required           |                                                      |
| App review        | ❗ Required if publishing | Required only when publishing the integration.       |
| Security audit    | ✅ Not required           |                                                      |

## Setup guide

<Steps>
  <Step title="Create a Sentry account">
    1. If you don’t already have a Sentry account, go to [sentry.io](https://sentry.io) and sign up for a free account.
    2. Sign in to your Sentry account.
  </Step>

  <Step title="Create a new Nango integration">
    1. Navigate to **Integrations**, then click **Configure New Integration**.
    2. Search for **Sentry (Public Integrations)** and select it.
    3. You can leave the **Client ID** and **Client Secret** fields empty for now — you’ll fill them in later.
  </Step>

  <Step title="Create a new Sentry integration">
    1. Naviagate to **Settings** > **Custom Integrations**.
    2. Click **Create New Integration** and select **Public Integration** then click **Next**.
  </Step>

  <Step title="Configure your integration">
    Fill in the required fields:

    1. **Name**: Enter a name for your integration (e.g., “My App Integration”).
    2. **Author**: The company or person who built and maintains this Integration.
    3. **Webhook URL**: You can find the specific **Webhook URL** on the integration page of the Nango integration you created earlier in Step 2.
    4. Under **PERMISSIONS**, configure the required scopes for your integration.
  </Step>

  <Step title="Obtain your OAuth credentials">
    After saving your integration, you’ll receive:

    * **Client ID**
    * **Client Secret**

    These will be used when configuring your integration in Nango.
  </Step>

  <Step title="Configure your integration in Nango">
    Using the integration you created earlier within Nango, enter your **Client ID** and **Client Secret** from the previous step, then save your changes.
  </Step>

  <Step title="Submit for review (if publishing publicly)">
    1. Once your integration is ready for public use, ensure that you have a [valid](https://docs.sentry.io/organization/integrations/integration-platform/public-integration/#image-requirements) logo, navigate to **Settings** > **Custom Integrations**.
    2. Click **Publish** next to your integration.
    3. This will notify the Sentry team (via email) that your app is ready for review.

    Public integrations require review before being listed in the Sentry marketplace.
  </Step>

  <Step title="Next">
    Follow the [*Quickstart*](/getting-started/quickstart).
  </Step>
</Steps>

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

## Useful links

| Topic     | Links                                                                                                                                       |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| General   | [Sentry Website](https://sentry.io/welcome/)                                                                                                |
|           | [Create a Sentry Account](https://sentry.io/signup/)                                                                                        |
| Developer | [Integration Platform Overview](https://docs.sentry.io/product/integrations/integration-platform/)                                          |
|           | [API Reference](https://docs.sentry.io/api/)                                                                                                |
|           | [Authorization & OAuth Guide](https://docs.sentry.io/api/auth/)                                                                             |
|           | [Public Integration](https://docs.sentry.io/organization/integrations/integration-platform/public-integration/#publication)                 |
|           | [Public Integration OAuth Process](https://docs.sentry.io/organization/integrations/integration-platform/public-integration/#oauth-process) |
|           | [Public Integration Publication](https://docs.sentry.io/organization/integrations/integration-platform/public-integration/#publication)     |
|           | [Rate Limits](https://docs.sentry.io/api/ratelimits/)                                                                                       |
|           | [Alerts & Notifications](https://docs.sentry.io/api/alerts/)                                                                                |

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/sentry-oauth.mdx)</Note>

## API gotchas

* A partial connection is created when initiating the OAuth flow for a Sentry public integration in Nango. This connection remains in a pending state until the user manually accepts and installs the integration from the Sentry Public Integrations page (via the Accept & Install button).

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/sentry-oauth.mdx)</Note>

## Going further

<Card title="Connect to Sentry (Public Integrations)" icon="link" href="/integrations/all/sentry-oauth/connect" horizontal>
  Guide to connect to Sentry (Public Integrations) with an Auth Token using Connect UI
</Card>