Webhooks and events
Register signed HTTPS endpoints for operation.completed, charging_session.status_changed, bill.finalized, display.delivery_changed and the charger events (station.connected, station.disconnected, station.booted, connector.status_changed, station.fault_opened, station.fault_cleared, meter.sampled; optional stations filter and meter sample interval), inspect delivery attempts and poll the same events by cursor with type and station_id filters. Requires webhooks:write to manage endpoints plus the read scope of each subscribed event. Deliveries are at-least-once with backoff; deduplicate by event id.
7 endpoints
- getList webhook endpoints/v1/tenants/{tenant_id}/webhooks
- postRegister an HTTPS endpoint for tenant events/v1/tenants/{tenant_id}/webhooksRequires webhooks:write plus the read scope of each subscribed event type.
- getRead one webhook endpoint/v1/tenants/{tenant_id}/webhooks/{webhook_id}
- deleteDisable a webhook endpoint/v1/tenants/{tenant_id}/webhooks/{webhook_id}Pending deliveries are marked failed.
- postQueue a signed webhook.test delivery/v1/tenants/{tenant_id}/webhooks/{webhook_id}/testDelivers only to this endpoint regardless of its subscriptions.
- getRead delivery attempts for an endpoint/v1/tenants/{tenant_id}/webhooks/{webhook_id}/deliveries
- getPoll tenant events by cursor/v1/tenants/{tenant_id}/eventsThe same events webhooks deliver, in ascending sequence, for recovery or polling.