Consume UtilityAPI meter data-ready webhooks and handle asynchronous data delivery for authorized meters

Steps

1. In the UtilityAPI dashboard, configure a webhook endpoint URL under Settings > Webhooks; UtilityAPI will POST a JSON payload to this URL when meter data collection completes or when a new authorization is created.
2. Validate incoming webhook requests by checking the UtilityAPI-Signature header against an HMAC-SHA256 of the raw request body using your webhook secret; reject requests where signatures do not match to prevent spoofed callbacks.
3. Parse the webhook payload: the 'event' field identifies the event type (e.g., 'meters.updated', 'authorizations.updated'); for 'meters.updated', extract the 'meters' array containing meter UIDs that have new data available.
4. For each meter UID in the webhook payload, call GET /api/v2/meters/{uid}/intervals to retrieve the newly available interval data; use the 'updated_since' query parameter set to the webhook's timestamp to fetch only new intervals rather than re-downloading all historical data.
5. Implement idempotent processing: UtilityAPI may deliver the same webhook more than once (at-least-once delivery); use the 'uid' field from the payload as a deduplication key and check whether the event has already been processed before performing downstream actions.
6. Respond to the webhook POST with HTTP 200 within a few seconds; perform heavy processing asynchronously in a background job — a slow or error-returning response will trigger UtilityAPI's retry logic with increasing backoff.