Event Types¶
When you create a webhook, you subscribe it to one or more events. Capawesome Cloud then sends a request each time one of those events occurs.
The following events are currently supported:
| Event | Fires when |
|---|---|
app_build_created |
A new app build is created. |
app_deployment_created |
A new deployment is created. |
job_created |
A new job is created. |
job_finished |
A job finishes (succeeded, failed, or canceled). |
Resource events vs. job events¶
It helps to know the difference between the two kinds of events:
- Resource events (
app_build_created,app_deployment_created) fire the moment a build or deployment is created — useful to know that work has started. - Job events (
job_created,job_finished) track the execution behind that work. Every build and deployment runs as a job, sojob_finishedis the event to subscribe to when you care about the outcome — its payload carries the finalstatusand links back to the build or deployment viaappBuildId/appDeploymentId.
In practice, most integrations subscribe to job_finished to react to a build or deployment succeeding or failing.
The request body for every event follows the same envelope — see Payload structure.
Need an event that's not listed here? Let us know and we'll look into adding it.