> 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/bugsnag.md).

# BugSnag

### 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 BugSnag

1\. In BugSnag open the project and go to **Settings → Data forwarding**.

2\. Enable the **Webhook** integration and paste the Pagerly webhook URL.

3\. Choose which events forward - typically **new error** and **error state change**.

BugSnag's payload is fixed, so there is nothing to paste.

### Notes

* **Deduplication** uses `error.errorId`, so repeated occurrences of the same error update one incident.
* **Severity** comes from `error.severity`: `error` maps to SEV 1, `warning` to SEV 2, `info` to SEV 3.
* **Resolution** comes from `error.status`, not the trigger: `fixed`, `snoozed` and `ignored` all resolve the incident, `open` keeps it open.
