Complete the UtilityAPI customer authorization onboarding flow to obtain an Authorization object and its associated meters for a new customer.

Steps

1. Create an API token in account Settings and send it as Authorization: Bearer <TOKEN> on all API v2 calls (base URL https://utilityapi.com/api/v2/).
2. Create a hosted authorization Form via POST /api/v2/forms (Forms are built from a Template object); the response returns a Form uid and a hosted url.
3. Send or embed the Form's url to the customer so they can log in to their utility account and grant data-sharing consent; for testing, use POST /api/v2/forms/{uid}/test-submit with a DEMO utility instead of a real customer.
4. On completion, the customer is redirected with a referral query parameter (test-submit returns this value directly in its JSON response).
5. Call GET /api/v2/authorizations?referrals={referral}&include=meters to retrieve the resulting Authorization object (with its own uid) plus the Meter object(s) it grants access to.
6. Activate the returned meter uid(s) via POST /api/v2/meters/historical-collection to begin collecting data, then poll GET /api/v2/meters/{uid} until status is updated and bill_count is greater than zero.