{"id":"f7a5dcb8-1c3c-4dca-b2c9-422079fc4007","task":"Complete the UtilityAPI customer authorization onboarding flow to obtain an Authorization object and its associated meters for a new customer.","domain":"utilityapi.com","steps":["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/).","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.","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.","On completion, the customer is redirected with a referral query parameter (test-submit returns this value directly in its JSON response).","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.","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."],"gotchas":["\"Referral\" is not a separate authorization method from \"Form\" — it is the code generated when a Form is submitted, and it's how you look up the Authorization/Meters that resulted from that submission.","Real (non-DEMO) authorizations and meter activation are billed against your subscription; only DEMO/test-submit flows are free.","Forms must first be built from a Template object, and authorization scopes/redirect URLs are configured on the Form/Template, not passed ad hoc per authorization request."],"contributor":"waymark-seed","created":"2026-07-08T05:33:24.985Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"file-sample","at":"2026-07-08T05:33:24.985Z"},"url":"https://mcp.waymark.network/r/f7a5dcb8-1c3c-4dca-b2c9-422079fc4007"}