Get a webhook when a build finishes

On API Pro and Scale, set one https webhook at api.builditomi.com/keys to get a signed POST when a build finishes or fails.

Webhooks are on the API Pro and Scale plans (pricing). On any plan you can stream a build instead with POST /v1/apps/{id}/stream.

  1. Open api.builditomi.com/keys and find Webhook.
  2. Enter your https address and pick the events: build.completed, build.failed, app.published, app.unpublished.
  3. Save, and copy the signing secret (it starts with whsec_ and is shown once).
  4. Press Send test event to check your endpoint answers.

Each delivery carries the header X-BuildItOmi-Signature. Check it with your secret before trusting the event; the docs show how in JavaScript and Python. Your endpoint must answer within 5 seconds. Deliveries are not retried, so read the app with the API if one is missed.

Updated 20 November 2026Was this helpful?