> For the complete documentation index, see [llms.txt](https://docs.meta-inf.hu/email-this-issue/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meta-inf.hu/email-this-issue/administration/alerting-via-webhooks/webhooks/opsgenie-configuration-to-receive-webhooks.md).

# Configuring JSM Alerts to Receive alerts via webhooks

## Create the integration in JSM

1. Settings → Products → Jira Service Management → Integrations → Add integration
2. Select **API**\
   ![](/files/M0u1N1WdtKwWNOB3SawO)
3. Name the integration and select an assignee team\
   ![](/files/0stSphCpF08Uy4oVHQ44)
4. Copy the API key:<br>

   <figure><img src="/files/0AgC4e3Nm3ctqOvuztNX" alt=""><figcaption></figcaption></figure>

## Create the webhook in Email This Issue

1. Open Email This Issue → Administration → Webhooks → Add → Add custom webhook
2. Fill out the required details:
   1. Name: custom name
   2. Description
   3. Event: select the event you want to create the alert for (reference our [Alerting via Webhooks](/email-this-issue/administration/alerting-via-webhooks.md) article for the available event types).
   4. Service URL: `https://api.atlassian.com/jsm/ops/integration/v2/alerts`&#x20;
   5. API Token - paste the API key from step 3 above.
   6. Request Header: `Authorization: GenieKey $!token`&#x20;
   7. Request Body: a JSON-formatted message payload that contains [JSM parameters](https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v1/api-group-integration-events/#api-jsm-ops-integration-v2-alerts-post-request-body) with either hard-coded values or values from [our variables](https://docs.meta-inf.hu/email-this-issue/administration/alerting-via-webhooks/webhooks#webhook-variables).&#x20;

```
{
    "message": "$!message",
    "alias": "$!entity.type - $!entity.id",
    "description": "$!details",
    "tags": [
        "Critical"
    ],
    "details": {
        "Entity Name": "$!entity.name",
        "Entity Type": "$!entity.type",
        "Entity ID": "$!entity.id",
        "Entity Link": "$!entity.link",
        "Jira Base Url": "$!jiraBaseUrl",
        "Incident Timestamp": "$!timestamp"
    },
    "entity": "Email This Issue",
    "priority": "P1"
}
```

{% hint style="info" %}
In the above example we provide a lot of information in the details parameter, to see this in the alert itself, you need to edit the rule in JSM side to save the information to specific alert fields.
{% endhint %}