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:

  • Build:

    • Build success:

      • 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
    • Build failure:

      • 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 sends 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 manager or developer permissions in the app to be able to create and configure the webhooks. We currently support webhooks for Slack and Microsoft Teams.

Getting Started

  1. Navigate to App Center, and select the specific app you would like for webhooks integration.

  2. In your app, in the far left hand panel, select Settings

  3. 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.

    How to edit the webhook's settings

  4. In the top right hand corner, click the blue New Webhook button and enter:

    • Webhook name

    • Webhook URL

      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.

      How to create a new webhook

  5. Done! Your webhook is now created and enabled. You may create multiple webhooks by repeating step 4.

  6. 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:

Build success notification on Slack

An example of a webhook payload in JSON is:

  "app_name": "myFirstApp",
  "branch": "master",
  "build_status": "Succeeded",
  "build_id": "33",
  "build_link": "{user-id}/apps/{app-name}/build/branches/master/builds/33",
  "build_reason": "manual",
  "finish_time": "2018-06-14T23:59:05.2542221Z",
  "icon_link": "",
  "notification_settings_link": "{user-id}/apps/{app-name}/settings/notifications",
  "os": "iOS",
  "start_time": "2018-06-14T23:57:03.4379381Z",
  "source_version": "55820a357ba26831f2eeb3be9973a4ef20618b73",
  "sent_at": "2018-06-14T23:59:08.4897604Z"

Custom webhook support

To post to other platforms, you can write an Azure function that translates the way we POST to fit the requirements of the platform. To do that, create an Azure function, paste the URL under the Webhook URL field in step 4, and App Center will post the webhook payload to that endpoint. You may then modify the payload to the platform's requirements.