# Incoming Integration Payload

## Payload Mapping

1\. Navigate to [https://workspace.pagerly.io/inbound](https://pagerly-git-feat-escalation-kritik-kapoors-projects.vercel.app/inbound)

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/18580f83-0a41-4947-ae30-d8dcf779b0ff/ascreenshot.jpeg?tl_px=0,0\&br_px=1528,854\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=219,333)

2\. Select the added integration you want to update.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/e8dbbf52-a450-473a-8796-35c34f634310/ascreenshot.jpeg?tl_px=411,0\&br_px=1940,854\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=318,372)

3\. Click "PAYLOAD MAPPING"

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/ae1835e0-62fa-42ea-b0f8-d445d88f2afd/ascreenshot.jpeg?tl_px=447,0\&br_px=1976,854\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=366,331)

4\. You can review the payloads that Pagerly received from the integration to use them as a template or example for your attribute mapping.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/250fae69-5e92-402d-9fcc-73866641cd0f/ascreenshot.jpeg?tl_px=187,0\&br_px=2940,1538\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=532,199)

5\. Below you can find the mapping component that maps the payload to a Pagerly incident.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/1fcec2b0-1e91-41fb-8db2-68d4003f5cb0/ascreenshot.jpeg?tl_px=409,495\&br_px=2375,1594\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=724,376)

6\. Click "Edit"

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/81ab71d6-3364-49a1-aac8-530bd5264fc7/ascreenshot.jpeg?tl_px=188,55\&br_px=2940,1594\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=973,428)

7\. Update the source field to which the attribute will point.\
**Note:** If you set the source field as "No Source", then the attribute will point to the mapping value by default.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/5695b1a1-1e42-4554-ad8e-806b6e7f50cd/ascreenshot.jpeg?tl_px=974,0\&br_px=2940,1098\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=634,325)

8\. Click "Add Mapping"

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/a348cdf7-ea31-4c65-84f0-b2c579d7cd78/ascreenshot.jpeg?tl_px=188,55\&br_px=2940,1594\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=586,320)

9\. Click the "Add Mapping" button to add a new key-value pair.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/eabce5b3-851a-45f6-be2f-48f9de7d0e28/ascreenshot.jpeg?tl_px=974,0\&br_px=2940,1098\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=535,464)

10\. Example: Added key: P6 and value: SEV3

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/15e16678-4b08-46c3-a0e8-202af440ec3c/ascreenshot.jpeg?tl_px=974,287\&br_px=2940,1386\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=568,421)

11\. You can also update the fallback value.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/26009cae-9107-48ac-931a-96652c9f787b/ascreenshot.jpeg?tl_px=974,495\&br_px=2940,1594\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=750,337)

12\. Mapping field updated successfully!

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/633fb747-c3de-4adb-8a07-81fd96703d36/ascreenshot.jpeg?tl_px=188,55\&br_px=2940,1594\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=556,407)

13\. Some attribute fields, such as `link`, `description`, and `title`, are string-based values rather than key-value pairs.\
**Note:** When the New source field is set to 'No Source', then 'Fallback value' is required.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/466687fb-1b8d-466f-9675-813bb8374d04/ascreenshot.jpeg?tl_px=543,288\&br_px=2509,1386\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=641,363)

14\. Example: Source set to 'No Source' and fallback value is added.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-08-01/6b6bc178-6d88-4de7-87f5-857c3d17700a/ascreenshot.jpeg?tl_px=448,418\&br_px=2414,1517\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=869,406)

### Automatic Incident Creation with Observability Tools

Following Integrations are supported by Pagerly for automatically creating incidents

* [AWS Cloudwatch](/incidents-and-users/aws-cloudwatch.md)
* [Grafana](/incidents-and-users/grafana.md)
* [Datadog](/incidents-and-users/datadog.md)
* [Sentry](/incidents-and-users/sentry.md)
* [Prometheus](/incidents-and-users/prometheus.md)

For more , reach out to us <hello@pagerly.io>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pagerly.io/incidents-and-users/incoming-integration-payload.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
