> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/overview.md).

# Configure External Systems to Send Webhooks

After creating a webhook integration in Harness AI SRE, configure your external monitoring tool, CI/CD system, or cloud platform to send webhook notifications to the unique webhook URL.

### Overview <a href="#overview" id="overview"></a>

This section provides step-by-step configuration guides for popular external systems. Each guide walks you through:

1. **Locating webhook settings** in the external platform
2. **Configuring the webhook URL** provided by Harness
3. **Selecting events and triggers** to send
4. **Testing the integration** to verify data flow
5. **Troubleshooting** common configuration issues

***

### How to use these guides <a href="#how-to-use-these-guides" id="how-to-use-these-guides"></a>

#### Step 1: Create a webhook in Harness <a href="#step-1-create-a-webhook-in-harness" id="step-1-create-a-webhook-in-harness"></a>

Before configuring the external system:

1. Navigate to **Integrations**, then **New Integration** in Harness AI SRE.
2. Select the appropriate **webhook template** for your tool.
3. Copy the **webhook URL** displayed after saving.

Go to [Ingest Alerts](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/overview.md) for detailed webhook creation steps.

#### Step 2: Configure the external system <a href="#step-2-configure-the-external-system" id="step-2-configure-the-external-system"></a>

Use the relevant guide below to configure your external tool to send webhooks to Harness. Each guide provides:

* **Navigation paths** to webhook settings in the external platform
* **Required configuration** (URL, headers, authentication)
* **Event selection** guidance
* **Payload examples** showing what data is sent
* **Test procedures** to verify the integration

#### Step 3: Verify alert creation <a href="#step-3-verify-alert-creation" id="step-3-verify-alert-creation"></a>

After configuration:

1. Trigger a test alert in the external system.
2. Check that the alert appears in Harness AI SRE.
3. Verify field mapping is correct.
4. Review the alert timeline for any errors.

***

### Available integration guides <a href="#available-integration-guides" id="available-integration-guides"></a>

#### Monitoring and observability <a href="#monitoring-and-observability" id="monitoring-and-observability"></a>

Detailed external setup guides are available for these monitoring platforms:

* [Datadog](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/monitoring/datadog.md): Configure Datadog monitors to send alerts via webhook.
* [PagerDuty](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/monitoring/pagerduty.md): Set up PagerDuty webhook extensions and V3 webhooks.
* [Prometheus (AlertManager)](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/monitoring/prometheus.md): Configure AlertManager webhook receivers.
* [Grafana](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/monitoring/grafana.md): Set up Grafana Unified Alerting contact points.
* [New Relic](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/monitoring/new-relic.md): Configure New Relic Applied Intelligence workflows.
* [Opsgenie](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/monitoring/opsgenie.md): Set up Opsgenie outgoing webhook integrations.
* [Splunk](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/monitoring/splunk.md): Configure Splunk alert actions to send webhooks.

**Additional monitoring tools**

These tools have webhook templates in Harness but use standard webhook configuration (go to each tool's official documentation for details):

* **Dynatrace:** Go to the [Dynatrace webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/monitoring/dynatrace.md) to configure the integration.
* **Sentry:** Go to the [Sentry webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/monitoring/sentry.md) to configure the integration.
* **Lacework:** Go to the [Lacework webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/monitoring/lacework.md) to configure the integration.
* **BigPanda:** Go to the [BigPanda webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/monitoring/bigpanda.md) to configure the integration.
* **AlertSite:** Go to the [AlertSite webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/monitoring/alertsite.md) to configure the integration.
* **Grafana Incident:** Go to the [Grafana Incident webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/monitoring/grafana-incident.md) to configure the integration.
* **Harness SLO:** Go to the [Harness SLO webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/monitoring/harness-slo.md) to configure the integration.

#### Cloud platforms <a href="#cloud-platforms" id="cloud-platforms"></a>

Detailed external setup guides are available for these cloud platforms:

* [AWS CloudWatch](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/cloud/aws-cloudwatch.md): Configure CloudWatch alarms with SNS and HTTPS subscriptions.

#### CI/CD and development <a href="#cicd-and-development" id="cicd-and-development"></a>

Detailed external setup guides are available for:

* [GitHub](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/cicd/github.md): Set up GitHub repository and organization webhooks.
* [GitLab](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/cicd/gitlab.md): Configure GitLab project and group webhooks.

**Additional CI/CD tools**

These tools have webhook templates in Harness but use standard webhook configuration:

* **Bitbucket:** Go to the [Bitbucket webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/cicd/bitbucket.md) to configure the integration.
* **Travis CI:** Go to the [Travis CI webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/cicd/travis-ci.md) to configure the integration.
* **Octopus Deploy:** Go to the [Octopus Deploy webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/cicd/octopus-deploy.md) to configure the integration.

#### ITSM and ticketing tools <a href="#itsm-and-ticketing-tools" id="itsm-and-ticketing-tools"></a>

These tools have webhook templates in Harness but use standard webhook configuration:

* **Jira:** Go to the [Jira webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/itsm/jira.md) to configure the integration.
* **ServiceNow:** Go to the [ServiceNow webhook template](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/itsm/servicenow.md) to configure the integration.

For bidirectional synchronization with Jira and ServiceNow, also configure:

* Go to the [Jira runbook integration](/ai-sre/ai-sre-for-administrators/set-up-runbook-management/integrations/ticketing/jira.md) to create and update issues.
* Go to the [ServiceNow runbook integration](/ai-sre/ai-sre-for-administrators/set-up-runbook-management/integrations/ticketing/servicenow.md) to post work notes and updates.

***

### Common configuration patterns <a href="#common-configuration-patterns" id="common-configuration-patterns"></a>

#### Basic webhook configuration <a href="#basic-webhook-configuration" id="basic-webhook-configuration"></a>

Most tools follow this pattern:

1. **Webhook URL:** Paste the Harness webhook URL.
2. **HTTP method:** POST (default for most tools).
3. **Content-Type:** `application/json`.
4. **Events:** Select relevant events (alerts, incidents, deployments).
5. **Authentication:** Usually none required (secret in URL path).

#### Advanced configuration <a href="#advanced-configuration" id="advanced-configuration"></a>

Some platforms support:

* **Custom headers:** Add authentication tokens or metadata.
* **Payload templates:** Customize the JSON structure before sending.
* **Conditional triggers:** Only send webhooks for specific conditions.
* **Batch delivery:** Group multiple events in a single webhook.
* **Retry logic:** Automatic retry on delivery failure.

#### Testing webhooks <a href="#testing-webhooks" id="testing-webhooks"></a>

Always test webhook configuration:

1. **Trigger a test event** in the external system.
2. **Check delivery logs** in the external platform (if available).
3. **Verify alert creation** in Harness AI SRE.
4. **Review field mapping** to ensure correct data extraction.
5. **Check error logs** if webhook delivery fails.

***

### Troubleshooting common issues <a href="#troubleshooting-common-issues" id="troubleshooting-common-issues"></a>

<details>

<summary>External system reports webhook delivery failure or timeout to Harness</summary>

Verify the webhook URL is exactly as provided by Harness with no extra spaces or characters, check network connectivity from the external system to Harness, ensure no firewall rules block outbound HTTPS traffic, and confirm the webhook is enabled and not in Quiet Mode.

</details>

<details>

<summary>Webhook delivery succeeds but alerts do not appear in Harness AI SRE</summary>

Confirm field mapping extracts required fields such as title and description, verify the payload structure matches the webhook template, review route alerts so alerts are not filtered out, confirm the correct template was selected, and check the webhook event log for parsing errors.

</details>

<details>

<summary>Alerts appear in Harness with missing or incorrect field mapping</summary>

Review the webhook payload structure in the external system, update JSONPath expressions in saved fields to match the payload, adjust Mustache templates in mapped fields, and test with sample payloads using the webhook test feature.

</details>

<details>

<summary>The same webhook alert appears multiple times in Harness</summary>

Confirm only one webhook integration is configured for the external system, review route alerts for duplicate routing, verify the external system is not sending duplicate webhook POSTs, and consider alert deduplication rules based on unique identifiers.

</details>

<details>

<summary>External system requires webhook authentication that is not configured</summary>

Most Harness webhooks do not require authentication because the secret is in the URL path. For a challenge response, contact Harness support. For SNS subscription confirmation with AWS CloudWatch, follow the CloudWatch guide, and confirm the webhook URL includes the secret key portion.

</details>

***

### Best practices <a href="#best-practices" id="best-practices"></a>

#### Configuration management <a href="#configuration-management" id="configuration-management"></a>

Follow these practices to keep webhook configuration maintainable:

* **Document webhook URLs:** Store webhook URLs securely (they contain secrets).
* **Use descriptive names:** Name webhooks clearly in both systems.
* **Version control:** Document webhook configurations in runbooks.
* **Test thoroughly:** Always test before relying on webhooks in production.

#### Security <a href="#security" id="security"></a>

Follow these practices to protect webhook secrets:

* **Protect webhook URLs:** Treat webhook URLs as secrets (they contain authentication).
* **Rotate secrets:** If a webhook URL is compromised, delete and recreate the integration.
* **Limit access:** Only authorized users should access webhook configuration.
* **Use HTTPS:** All Harness webhooks use HTTPS by default.

#### Maintenance <a href="#maintenance" id="maintenance"></a>

Follow these practices to keep webhooks healthy over time:

* **Monitor webhook health:** Check delivery success rates in external systems.
* **Update on platform changes:** External system updates may change payload structure.
* **Clean up unused webhooks:** Delete integrations that are no longer needed.
* **Document changes:** Record any modifications to webhook configuration.

#### Performance <a href="#performance" id="performance"></a>

Follow these practices to control webhook volume and load:

* **Batch when possible:** Some tools support batching multiple events.
* **Set appropriate retry policies:** Configure external system retry behavior.
* **Monitor volume:** High-volume webhooks may require rate limiting.
* **Use filters:** Only send relevant events to reduce noise.

***

### Next steps <a href="#next-steps" id="next-steps"></a>

#### Get started <a href="#get-started" id="get-started"></a>

* [Ingest Alerts](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/overview.md): Create a webhook integration in Harness.
* [Webhook Templates](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/overview.md): Browse available templates.
* [Use CEL in Webhooks](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/use-cel-webhooks.md): Filter webhook payloads.

#### Advanced configuration <a href="#advanced-configuration" id="advanced-configuration"></a>

* [Route Alerts](/ai-sre/ai-sre-for-administrators/set-up-alert-management/alert-rules/overview.md): Route and process webhook-generated alerts.
* [Create a Runbook](/ai-sre/ai-sre-for-administrators/set-up-runbook-management/create-runbook.md): Automate responses to webhook alerts.
* [AI SRE Best Practices](/ai-sre/troubleshooting-and-resources/ai-sre-best-practices.md): Optimize webhook integrations.

#### Get help <a href="#get-help" id="get-help"></a>

If you encounter issues not covered in these guides:

* Go to the external system's official webhook documentation to confirm required settings.
* Review the webhook event log in Harness for detailed error messages.
* Contact Harness support with webhook delivery logs from both systems.