Sentry

Integration version2.0.0

Overview

Sentry has deprecated legacy webhook integrations and now recommends using Sentry Internal Integrations with webhooks to forward events to external systems.

To forward events to Datadog, you must configure a webhook integration directly in Sentry. This setup allows Sentry to send events to a public endpoint of your choice supported by your organization.

More information and setup instructions are available in Sentry’s official documentation.

You can find the Datadog intake URL (for logs or events) in the Datadog API documentation or Datadog account settings.

Legacy Webhooks

If you previously configured Sentry’s legacy webhook integration, it may continue to function for now. However, all new webhook setups must use Sentry’s Internal Integrations going forward.

Setup

Configuration

Step 1: Deploy the Webhook Forwarder

Sentry webhooks cannot include custom headers. You must deploy a small service on your infrastructure that:

  • Accepts incoming webhook POSTs from Sentry
  • Adds required authentication headers
  • Forwards the payload to your destination

For more information, see the official Sentry documentation.

Step 2: Create an Internal Integration in Sentry

  1. Navigate to Settings > Developer Settings > Internal Integrations.

  2. Click Create New Internal Integration.

  3. Fill in:

    • Name: Alert Forwarder
    • Webhook URL: The public URL of your deployed service
    • Enable Alert Rule Action

  4. Set Permissions:

    • Issue & Event: Read
    • Alerts: Read

  5. Enable Webhook Triggers:

    • issue
    • error

  6. Click Save.

  7. Optionally generate a token if your proxy supports token-based authentication.

Step 3: Create an Alert Rule

  1. Navigate to Project Settings > Alerts > Issue Alerts.

  2. Create a new alert rule:

    • WHEN: A new issue is created
    • (Optional) Add filters
    • THEN: Send a notification using your internal integration
    • Set frequency and notification interval as needed

  3. Use the Send Test Notification option to verify the setup.

Step 4: Confirm Receipt

Once configured:

  • Monitor your destination system for forwarded alerts.
  • Confirm the payload structure and content match expectations.
  • Use logs from your proxy to debug delivery issues.

If alerts are not appearing:

  • Ensure your proxy is reachable from the public internet.
  • Validate that authentication headers are being correctly added.
  • Review Sentry’s webhook logs under Developer Settings > Internal Integrations > Your Integration > Logs.

Support

If you have questions or run into issues configuring Sentry’s webhook integration, please reach out directly to Sentry Support:
https://support.sentry.io