HomeGuidesAPI ReferenceChangelog
Log In
API Reference

Create a Connect URL

You can also send your users through the Connect flow by linking them to a unique Connect URL (provided by this endpoint).

Just like the Connect Token, you need to provide either a client_user_id or autility credential_id to get a URL that will initialize Connect in ‘create mode’ or ‘update mode’ respectively. See this page for a guide on the difference between those two modes. This endpoint will provide a URL in a response. Once you have the URL, provide it to the given user for them to complete Connect and give you access to their utility data. The URL will expire after 5 days. If you would like to provide your user with the [Connect tariff selection mode] (https://docs.arcadia.com/docs/connect-tariff-selection-mode) instead, pass tariff as the variant parameter.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string

The unique identifier for your user. This parameter is required for users entering the Connect flow for the first time. Note either client_user_id or utility_credential_id must be supplied to the endpoint for all requests.

integer

The id associated with the utility credential to be updated. This parameter is required for users entering Connect to update or repair an existing utility credential. Note that you must supply either client_user_id or utility_credential_id to the endpoint.

string

The variant of Connect that the user will be sent through. Variant will default to 'connect'. To provide a user with the tariff-selection variant instead, pass tariff as the variant

Headers
string
required
Defaults to 2022-10-13

The Arcadia-Version for the request

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json