> For the complete documentation index, see [llms.txt](https://docs.pagerly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagerly.io/incidents-and-alerting/integrations/honeycomb.md).

# Honeycomb

### Create the integration in Pagerly

1\. Navigate to <https://workspace.pagerly.io/inbound> and click **"Add Inbound Integration"**.

2\. Set a display name, select the team this integration belongs to, choose the integration below, and click **"Add Integration"**.

3\. Copy the generated webhook URL - you will paste it into the tool in the next section.

### Configure Honeycomb

1\. In Honeycomb go to **Team settings → Integrations** and add a new integration with **Provider: Webhook**.

2\. Paste the Pagerly webhook URL.

3\. Under **Customize Webhook Payload**, paste:

```json
{
  "title": "{{ .Alert.Summary }}",
  "description": "{{ .Description }}",
  "source_url": "{{ .Resource.URL }}",
  "status": "{{ .Alert.Status }}",
  "deduplication_key": "{{ .Alert.InstanceID }}",
  "metadata": {
    "environment": "{{ .Environment }}",
    "name": "{{ .Name }}",
    "result_url": "{{ .Result.URL }}"
  }
}
```

4\. Attach the webhook to a **Trigger** or **SLO Burn Alert**.

### Notes

* **Deduplication** uses `.Alert.InstanceID`. Do not use the `X-Honeycomb-Webhook-Delivery-ID` header - that is constant across *retries of one delivery*, not across firings of the same alert.
* **Resolution**: `.Alert.Status` of `OK` resolves the incident; `TRIGGERED` opens it.