Skip to main content

​
Before you begin

Make sure you have:
  • A Potpie account
  • A Sentry account with permission to authorize OAuth applications on your organization
The same Sentry organization cannot be connected more than once per user. If you attempt to reconnect an already-linked organization, Potpie will return a duplicate error. Delete the existing integration first.

​
Connect your Sentry account

1

Open Integrations

Go to Potpie → Integrations.
2

Authorize Sentry

Click Connect Sentry and complete the OAuth consent screen on Sentry’s side. Potpie stores your access and refresh tokens encrypted in PostgreSQL, linked to your Sentry organization.

​
What Sentry data becomes accessible

Unlike the Jira and Confluence integrations, Sentry does not expose agent-callable tools. Instead, connecting Sentry makes your organization’s data available to the service layer — projects, issues, and events can be retrieved and used as context in conversations. The following data endpoints become active once you connect:
​
GET /integrations/sentry/{id}/organizations
endpoint
Lists all Sentry organizations accessible to the connected account.
​
GET /integrations/sentry/{id}/organizations/{org}/projects
endpoint
Lists all projects within a specific organization.
​
GET /integrations/sentry/{id}/organizations/{org}/projects/{project}/issues
endpoint
Returns issues for a specific project. Use this to retrieve error context for conversations about a codebase.
​
POST /integrations/sentry/{id}/api/{any_sentry_endpoint}
endpoint
Generic passthrough to any Sentry API endpoint. All requests go through Potpie’s token layer, so your credentials are never exposed directly.

​
Token refresh

Potpie automatically refreshes your Sentry access token when it expires. No action is required from you — data access continues without interruption across token cycles.

​
Webhooks

Sentry can push issue and project events to Potpie in real time. A few things to know:
  • Registration is manual — Potpie does not register webhooks automatically at connection time. You need to add the webhook URL on Sentry’s side yourself.
  • All event types are accepted — Potpie does not filter by event type. Any event Sentry sends is received and queued for processing.
  • Webhook endpoint:
POST /api/v1/integrations/sentry/webhook
To set this up, add the above URL as a webhook in your Sentry project settings under Settings → Integrations → WebHooks.

​
Disconnect Sentry

To remove the integration, go to Settings → Integrations in Potpie and disconnect Sentry. You can reconnect at any time — just note that reconnecting the same organization requires the previous integration to be deleted first.