Looking for the full interactive reference?
Open API Reference →Event catalog
Every event type the platform can emit. Subscribe by configuring a webhook endpoint inside the GA Flight console at Settings → Integrations → Webhooks.
Auto-rendered
This catalog was generated on 2026-08-26 from fallback. Run `npm run gen:event-catalog-snapshot` to refresh.
| Event | Stability | Fires when… | Example payload |
|---|---|---|---|
| flight.submitted | stable | A flight is submitted for approval. | Schema → |
| flight.approved | stable | A flight is approved and posted. | Schema → |
| flight.rejected | beta | A flight submission is rejected. | Schema → |
| maintenance.alert | beta | A maintenance due-item or work-order alert fires. | Schema → |
| compliance.updated | beta | A compliance record is created or updated. | Schema → |
| training.signoff.recorded | beta | A program item is signed off for a student. | Schema → |
| payment.received | beta | A payment is recorded against an invoice or enrollment charge. | Schema → |
| vtr.issued | beta | A Verifiable Training Record pack is built, signed, and issued. | Schema → |
| medical.expiring | beta | A pilot medical crosses a 60 / 30 / 14-day expiry threshold. | Schema → |
| webhook.test | stable | You click Ping on a webhook endpoint. | Schema → |
Subscribe
Webhook endpoints subscribe to a list of event types. Below is the shape of a delivery — headers and JSON envelope are identical across event types; only the data field varies.
http
POST /your/webhook/handler HTTP/1.1
Host: your-app.example.com
Content-Type: application/json
X-GA-Webhook-Delivery: 9f5f4f08-7c1c-4ad8-bca1-87b96e63c4f6
X-GA-Webhook-Timestamp: 2026-05-28T12:03:11Z
X-GA-Webhook-Signature: sha256=<hex(hmac(secret, rawBody))>
{
"event": {
"type": "flight.approved",
"id": "evt_01HZ...",
"occurred_at": "2026-05-28T12:03:10Z",
"data": { /* event-specific payload */ }
}
}Stability conventions
- stableSchema and emission contract frozen. Breaking changes require a major version.
- betaWired and emitted, but the schema may add or rename fields in a minor release. Build defensively.
- plannedReserved name; not yet emitted. Do not subscribe yet.