# Configure a Webhook in Slack

{% hint style="info" %}
After the 25.3.9 release, the structure of the webhook payload URL was updated. Customers need to update the webhook URL in the repository settings of their remote repo. Some customers are still using the old webhook URL containing **autorabitrest**, which should now be replaced with api.

Example:

Old URL: [https://na25.autorabit.com/**autorabitrest/**webhook/triggerSCMPushrequest](https://na25.autorabit.com/autorabitrest/webhook/triggerSCMPushrequest)

Updated URL: [https://na25.autorabit.com/api/webhook/v2/\<OrgName>/trigger-scm-push-request](https://na25.autorabit.com/api/webhook/v2/%3COrgName%3E/trigger-scm-push-request)

Unless you update the Payload URL, you might face pull request/trigger build-on-commit jobs triggering.
{% endhint %}

1. Log in to your **Slack** account.
2. Navigate to <https://api.slack.com/>
3. Click **Create an app**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FPihRrsGmOrxLWZyzMouH%2Fimage.png?alt=media&#x26;token=431220a1-ccec-45fd-8f3a-eabe3aadf178" alt="Slack API homepage with Create an app button highlighted" width="527"><figcaption></figcaption></figure>

4. On the **Create an app** screen, click **From scratch**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FO0Wmq0Jv6yE4IzBG5fd8%2Fimage.png?alt=media&#x26;token=573af146-e0bb-4bbf-ab48-59bc67c6e4b2" alt="Slack app creation screen with From scratch option selected" width="443"><figcaption></figcaption></figure>

5. Enter an **App Name**, choose a **Workspace** from the dropdown, and click **Create App**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FSzUVmtWSDmpahV2rDwJ3%2Fimage.png?alt=media&#x26;token=70f6649d-cc1d-460c-909a-f3c8b764a2c4" alt="Slack app naming and workspace selection screen" width="441"><figcaption></figcaption></figure>

6. In the app settings, click **Incoming Webhooks** under **Features** or **Add features and functionality**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FFqHMSkvyXFOwXPC5Uwrf%2Fimage.png?alt=media&#x26;token=6aa0b46f-d278-4bf6-9e61-bd1a0d8abcdc" alt="Slack app features page with Incoming Webhooks highlighted" width="563"><figcaption></figcaption></figure>

7. Activate **Incoming Webhooks** by toggling the switch from disabled to enabled.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FB7X8ISiNQkmPx5mzPSes%2Fimage.png?alt=media&#x26;token=064c903b-cce5-4f35-8024-f40b497bc0e1" alt="Toggle switch in disabled state"><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FaSFZJyIMQixNt5rbcF9j%2Fimage.png?alt=media&#x26;token=13636642-d417-4796-87ef-59028d065a25" alt="Toggle switch in enabled state"><figcaption></figcaption></figure>

8. Scroll down and click **Add New Webhook to Workspace**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FA1F8YHIYNMnXl2VagLVW%2Fimage.png?alt=media&#x26;token=fb1fc753-25e1-4033-af5a-4083795d3918" alt="Add new webhook to workspace button in Slack app configuration" width="458"><figcaption></figcaption></figure>

9. Choose the **channel** where notifications should be sent and click **Allow**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FkxN72G6uKvOh7L593wkn%2Fimage.png?alt=media&#x26;token=67b54cbd-52ce-4e8a-b477-ae6e02999858" alt="Slack channel selection screen for webhook integration" width="352"><figcaption></figcaption></figure>

10. After authorization, you'll return to the previous screen. Scroll down and click **Copy** to get the webhook URL.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FLyu25BIB37XeElDO5Cf7%2Fimage.png?alt=media&#x26;token=ef24c264-67de-4eca-ba91-74e458651dec" alt="Slack webhook URL section with Copy button" width="461"><figcaption></figcaption></figure>

The webhook URL can be reused or deleted from this section in Slack.

11. Finally, integrate your Slack webhook URL with ARM. For more guidance, refer to [this configuration guide](https://knowledgebase.autorabit.com/product-guides/arm/troubleshoot/how-tos/configure-mail-server-settings).


---

# 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://knowledgebase.autorabit.com/product-guides/arm/arm-features/webhooks/configure-a-webhook-in-slack.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.