Registering Endpoints
Create webhook endpoints under Integrations → Webhooks. Joulepoint signs every payload using an HMAC secret you control.
Events are retried with exponential backoff up to 24 hours. Use idempotency keys to deduplicate messages in your consumer.
Event Catalogue
Operational events include charge.session.started, charge.session.completed, charge.point.offline, and device.firmware.progress.
Billing events cover cdr.generated, invoice.created, and settlement.dispatched. Route these to your financial systems for automated reconciliation.
Consuming the Stream
For high-volume use cases, switch to the Real-Time Event Stream over gRPC. This multiplexes events across a persistent TLS connection, reducing webhook overhead.
The stream supports back-pressure handling. Acknowledge events within 30 seconds to keep the connection healthy.