Event types

Open in Claude Open in ChatGPT llms-full.txt

Every event is thin: data names the object and carries a few fields to route on. Fetch the object for its current state. Subscribe to exact types, a prefix such as fuel_log.*, or *; your key needs the scope listed for each type. Delivery, signatures and retries are in Webhooks. The same list is available at GET /v1/webhook_event_types.

52 event types across 14 kinds of object.

Fleet request

Event	When
`fleet_request.created` needs `fleet_requests:read`	A fleet request was raised.
`fleet_request.submitted` needs `fleet_requests:read`	A request was submitted for approval.
`fleet_request.returned` needs `fleet_requests:read`	A request was sent back to the requester for changes.
`fleet_request.approved` needs `fleet_requests:read`	Fleet approved a request: it is ready for the ERP.
`fleet_request.rejected` needs `fleet_requests:read`	Fleet rejected a request.
`fleet_request.in_service` needs `fleet_requests:read`	Work on the request started.
`fleet_request.service_confirmed` needs `fleet_requests:read`	Fleet confirmed the service was delivered (goods / service received).
`fleet_request.closed` needs `fleet_requests:read`	A request was closed.
`fleet_request.cancelled` needs `fleet_requests:read`	A request was cancelled.
`fleet_request.draft` needs `fleet_requests:read`	A request went back to draft.
`fleet_request.financial_status_changed` needs `fleet_requests:read`	A financial event changed the request's financial status (committed, ordered, billed, paid…).

Example payload

{
  "type": "fleet_request.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "fleet_request",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "number": "FR-000042",
    "vehicle_id": "0b7d4e2a-1c3f-4a5b-8d6e-9f0a1b2c3d4e"
  }
}

Cost entry

Event	When
`cost_entry.created` needs `costs:read`	A cost was recorded.
`cost_entry.updated` needs `costs:read`	A cost changed; its revision went up.
`cost_entry.voided` needs `costs:read`	A cost was deleted or no longer counts. Reverse it if you posted it.
`cost_entry.superseded` needs `costs:read`	The ERP's bill replaced this cost. Reverse it if you posted it.

Example payload

{
  "type": "cost_entry.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "cost_entry",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "vehicle_id": "0b7d4e2a-1c3f-4a5b-8d6e-9f0a1b2c3d4e"
  }
}

Accounting period

Event	When
`accounting_period.closed` needs `accounting:read`	Costs on or before closed_through are closed.

Example payload

{
  "type": "accounting_period.closed",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "accounting_period",
    "closed_through": "2026-10-31"
  }
}

Vehicle

Event	When
`vehicle.created` needs `vehicles:read`	Someone created a vehicle.
`vehicle.status_changed` needs `vehicles:read`	The status of a vehicle changed (data.status and data.previous_status).
`vehicle.deleted` needs `vehicles:read`	Someone deleted a vehicle.

Example payload

{
  "type": "vehicle.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "vehicle",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "vehicle_id": "0b7d4e2a-1c3f-4a5b-8d6e-9f0a1b2c3d4e"
  }
}

Fuel log

Event	When
`fuel_log.created` needs `fuel_logs:read`	Someone created a fuel log.
`fuel_log.updated` needs `fuel_logs:read`	Someone changed a fuel log.
`fuel_log.deleted` needs `fuel_logs:read`	Someone deleted a fuel log.

Example payload

{
  "type": "fuel_log.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "fuel_log",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "vehicle_id": "0b7d4e2a-1c3f-4a5b-8d6e-9f0a1b2c3d4e"
  }
}

EV charging session

Event	When
`ev_charging_session.created` needs `fuel_logs:read`	Someone created an EV charging session.
`ev_charging_session.updated` needs `fuel_logs:read`	Someone changed an EV charging session.
`ev_charging_session.deleted` needs `fuel_logs:read`	Someone deleted an EV charging session.

Example payload

{
  "type": "ev_charging_session.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "ev_charging_session",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "vehicle_id": "0b7d4e2a-1c3f-4a5b-8d6e-9f0a1b2c3d4e"
  }
}

Expense

Event	When
`expense.created` needs `expenses:read`	Someone created an expense.
`expense.updated` needs `expenses:read`	Someone changed an expense.
`expense.deleted` needs `expenses:read`	Someone deleted an expense.

Example payload

{
  "type": "expense.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "expense",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "vehicle_id": "0b7d4e2a-1c3f-4a5b-8d6e-9f0a1b2c3d4e"
  }
}

Work order

Event	When
`work_order.created` needs `work_orders:read`	Someone created a work order.
`work_order.updated` needs `work_orders:read`	Someone changed a work order.
`work_order.status_changed` needs `work_orders:read`	The status of a work order changed (data.status and data.previous_status).
`work_order.deleted` needs `work_orders:read`	Someone deleted a work order.
`work_order.completed` needs `work_orders:read`	A work order was completed: its costs are now in the cost ledger.

Example payload

{
  "type": "work_order.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "work_order",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "number": "WO-000123",
    "vehicle_id": "0b7d4e2a-1c3f-4a5b-8d6e-9f0a1b2c3d4e"
  }
}

Vehicle renewal

Event	When
`vehicle_renewal.created` needs `renewals:read`	Someone created a vehicle renewal.
`vehicle_renewal.updated` needs `renewals:read`	Someone changed a vehicle renewal.
`vehicle_renewal.status_changed` needs `renewals:read`	The status of a vehicle renewal changed (data.status and data.previous_status).
`vehicle_renewal.deleted` needs `renewals:read`	Someone deleted a vehicle renewal.

Example payload

{
  "type": "vehicle_renewal.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "vehicle_renewal",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "vehicle_id": "0b7d4e2a-1c3f-4a5b-8d6e-9f0a1b2c3d4e"
  }
}

Issue

Event	When
`issue.created` needs `issues:read`	Someone created an issue.
`issue.updated` needs `issues:read`	Someone changed an issue.
`issue.status_changed` needs `issues:read`	The status of an issue changed (data.status and data.previous_status).
`issue.deleted` needs `issues:read`	Someone deleted an issue.

Example payload

{
  "type": "issue.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "issue",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "vehicle_id": "0b7d4e2a-1c3f-4a5b-8d6e-9f0a1b2c3d4e"
  }
}

Inspection

Event	When
`inspection.submitted` needs `inspections:read`	An inspection was submitted.

Example payload

{
  "type": "inspection.submitted",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "inspection",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "vehicle_id": "0b7d4e2a-1c3f-4a5b-8d6e-9f0a1b2c3d4e"
  }
}

Purchase order

Event	When
`purchase_order.created` needs `purchase_orders:read`	Someone created a purchase order.
`purchase_order.updated` needs `purchase_orders:read`	Someone changed a purchase order.
`purchase_order.status_changed` needs `purchase_orders:read`	The status of a purchase order changed (data.status and data.previous_status).
`purchase_order.deleted` needs `purchase_orders:read`	Someone deleted a purchase order.

Example payload

{
  "type": "purchase_order.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "purchase_order",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "number": "PO000412"
  }
}

Part

Event	When
`part.created` needs `parts:read`	Someone created a part (stock changes included).
`part.updated` needs `parts:read`	Someone changed a part (stock changes included).
`part.deleted` needs `parts:read`	Someone deleted a part (stock changes included).

Example payload

{
  "type": "part.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "part",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10",
    "number": "BP-2041"
  }
}

Vendor

Event	When
`vendor.created` needs `vendors:read`	Someone created a vendor.
`vendor.updated` needs `vendors:read`	Someone changed a vendor.
`vendor.deleted` needs `vendors:read`	Someone deleted a vendor.

Example payload

{
  "type": "vendor.created",
  "timestamp": "2026-11-03T08:14:22.000Z",
  "data": {
    "object": "vendor",
    "id": "6f1c2b0e-8a43-4c1e-9d55-0c2b7f3e9a10"
  }
}