Customize your release with Webhooks

What are webhooks and why use them?

Webhooks enable you to listen to specific events in real-time without polling or making any requests. For instance, a new release is submitted, or a review has been approved on the app store. This allows you to customize your release process and automate your workflow without making any additional calls to the Wolfia API.

As an example, you can use webhooks to automatically send a Slack notification when a new release is submitted to the app store or ping your QA team when a new beta build is ready for testing.

We know that your release process is unique, and we want to make it as easy for you to integrate Wolfia into your workflow and automate your release process as much as possible.

How to setup webhooks on Wolfia?

To setup webhooks, you need to go to the Webhook section in your settings. You can then add a new webhook by clicking on the Create a webhook button. You will be then prompted to enter

1. Endpoint where you want to receive the webhook payload
2. Secret key to sign the payload with HMAC-SHA256
3. Description for the webhook

Note: It is recommended to use a secret key to verify the payload with our X-Wolfia-Signature header. This ensures that the webhook is coming from Wolfia and not from a malicious source.

How does it work?

Webhooks are sent to your server as a POST request with a JSON payload to the HTTP endpoint you specify. The payload contains information about the event that triggered the webhook.

{
  "event": "ios.appstore.review.started",
  "buildId": "17127a98-0989-46a8-a69a-b3a6378f653d",
  "cfBundleIdentifier": "app.wolfia",
  "cfBundleVersion": "1",
  "cfBundleShortVersionString": "1.0.0",
  "submittedAt": "2023-02-22T17:19:25.503847Z"
}

Where can I learn more?

You can learn more about the different webhook events and how to receive them in your server in the webhooks guide.

We are passionate about making mobile app releases as automated and easy as possible. If you have any questions or feedback, please reach out to us.