App Center Webhooks
Webhooks are a simple way to notify third party applications when a specified event has occurred. The main goal of webhooks is to communicate important information from App Center to users rather than having users come to the portal, or run API calls to be notified when certain events happen.
App Center's webhooks empower users to send automatic notifications to connected applications for the following events:
- Always: when your app builds successfully
- Only if previously failed: when your app has successfully built after one or more failed builds
- Never: you will not receive notifications for build success
- Always: when your app fails to build
- Only if previously successful: when your app has failed to build after one or more successful builds
- Never: you will not receive notifications for build failure
Crashes: when a crash group is created
Distribute: when a new version is released
App Center will send an HTTP POST payload to the webhook's specified URL. Webhooks are configured at the app level under the Settings page of your specified app. Users must have have manager or developer permissions in the app to be able to create and configure the webhooks.
Navigate to App Center, and select the specific app you would like for webhooks integration.
In your app, in the far left hand panel, select Settings
In the row panel titled Webhooks, go to the right hand corner and click on the pencil icon. This will bring up the Webhooks panel.
You can obtain the webhook URL from your integrated application's settings (for example, here are details on how to obtain the webhook URL from Microsoft Teams and how to obtain the webhook URL from Slack).
Select the dropdown for Build status notifications and the checkbox for Crashes and Distribute notifications to decide what events will trigger the webhook alerts.
Done! Your webhook is now created and enabled. You may create multiple webhooks by repeating step 3.
Toggle to the extreme right hand of the webhook to test, disable or delete the webhook.
- test will send a test alert to your connected application.
- disable keeps the webhook inactive but present in your dashboard.
- delete will remove the webhook from your dashboard.
When these events happen, App Center notifications are posted into your integrated applications. For example, here is how a Build success notification looks like with a connected Slack application: