# Configure a Webhook in Teams

{% 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 **Microsoft Teams** application.
2. In the left panel, click the **Apps** icon.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FqtR6VsLsYgTXHYE63nVw%2Fimage.png?alt=media&#x26;token=b8dcf1aa-0f8f-4034-9feb-d0f99441488f" alt="Microsoft Teams interface highlighting the Apps icon" width="349"><figcaption></figcaption></figure>

3. Search for **Incoming Webhook** and click on the corresponding app.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FJwzafOsDffSE0qD8WhlX%2Fimage.png?alt=media&#x26;token=7a6423cb-d90d-425d-abad-b345f95c0be2" alt="Search results for Incoming Webhook app in Teams"><figcaption></figcaption></figure>

4. Click **Add to a team**.

> Tip: Click the copy icon to save the configuration link in case you need to complete the setup via a browser.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FO4SFOat7E3d0XkFMZbEV%2Fimage.png?alt=media&#x26;token=9eb986bf-5fbe-41c4-bb42-f840ab751d4a" alt="Incoming Webhook setup screen with copy link option" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FOhyQP5aj6RAVCfZ8yXeL%2Fimage.png?alt=media&#x26;token=b76fd261-6e3c-47c2-84a3-696aa9bc1642" alt="Redirect to browser message for Teams webhook setup"><figcaption></figcaption></figure>

5. Type the **team or channel name** in the search field, select the target team, then click **Set up a connector**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F7v60QuxBxcODxTdYoH76%2Fimage.png?alt=media&#x26;token=f6c2c26c-a45c-4a27-b512-5681a994a826" alt="Select channel screen for configuring webhook in Teams" width="563"><figcaption></figcaption></figure>

6. Click **Add** for the **Incoming Webhook** option.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FO4WcJuKJbAFy4220aoof%2Fimage.png?alt=media&#x26;token=40188112-d59a-4a71-a4b1-3f58cd8d93a7" alt="Add Incoming Webhook option in Teams"><figcaption></figcaption></figure>

7. Enter a name for the webhook. Optionally, upload an image. Then click **Create**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F0ZfCFyWnsCxFyxGmmqCz%2Fimage.png?alt=media&#x26;token=d178cf11-953e-4ccc-98d8-ce7c23720f6a" alt="Configure webhook screen showing name and upload image fields" width="530"><figcaption></figcaption></figure>

8. Copy the displayed webhook URL and save it securely (e.g., in Notepad), as it won't be shown again. Click **Done** once saved.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FQ4IGMIU4Kk5a0gEdZ0A8%2Fimage.png?alt=media&#x26;token=46eae9b9-5666-4dad-b4e2-59ad7dee40f0" alt="Webhook URL copy screen with Done button"><figcaption></figcaption></figure>

9. Integrate the Teams webhook URL with ARM. For integration steps, refer to the [Notifications & Mail Server Settings guide](https://knowledgebase.autorabit.com/product-guides/arm/troubleshoot/how-tos/notifications-mail-server-settings).