Payload format

All webhook deliveries are HTTP POST requests with a JSON body. There are two event categories:

Data Change Events

Triggered when a contribution (create, update, or delete) is merged for any of the non-flight event types.

{
  "event": "DATA_CHANGE",
  "timestamp": "2026-05-15T14:30:00",
  "data": {
    "type": "AIRPORT",
    "aid": "APTxxxxxxxx",
    "action": "CREATE",
    "url": "https://api.aviowiki.com/airports/APTxxxxxxxx"
  }
}
Field
Description

event

Always DATA_CHANGE for non-flight events

timestamp

When the event occurred (ISO 8601)

data.type

The event type matching your subscription

data.aid

The aviowiki identifier of the affected entity

data.action

One of CREATE, UPDATE, or DELETE

data.url

Direct API link to fetch the full entity

Use the data.url to retrieve the complete, up-to-date entity from the API.

Flight Update Events

Triggered when a tracked aircraft changes state.

Field
Description

event

Always FLIGHT_UPDATE for flight events

data.id

The flight identifier

data.action

The flight event action (see below)

data.url

Direct API link to fetch the full flight

data.parent.aid

The aircraft's aviowiki identifier

data.parent.registration

The aircraft registration (tail number)

Flight Actions:

Action
Description

OFF_BLOCK

Aircraft has pushed back from the gate

ON_BLOCK

Aircraft has arrived at the gate

TAKE_OFF

Aircraft has taken off

LANDING

Aircraft has landed

APPROACH

Aircraft is on approach

OFF_ROUTE

Aircraft has deviated from planned route

RETURN_TO_STAND

Aircraft is returning to the stand

INITIATE_EMERGENCY

Emergency declared

END_EMERGENCY

Emergency cancelled

DIVERSION

Aircraft is diverting to another airport