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.
- Open api.builditomi.com/keys and find Webhook.
- Enter your https address and pick the events: build.completed, build.failed, app.published, app.unpublished.
- Save, and copy the signing secret (it starts with whsec_ and is shown once).
- 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.