Create a Connect session Beta
Start the hosted page your user follows to pair a device and approve scopes
Beta. This endpoint is live for design partners, with keys that Dopl issues while the developer portal is being built.
POST /v1/connect_sessions
Creates the end user the first time it sees the external_user_id. The returned url opens the hosted page for 30 minutes; when the user finishes, the page redirects to redirect_uri with a public_token query parameter. Key scope connect.
Authorizations
AuthorizationA project secret key, or a publishable pk_… key from your app, sent as Authorization: Bearer <key>. This is the only route a publishable key may call.
Idempotency-KeyOptional and accepted for consistency. This route does not replay responses.
Body
external_user_idYour own ID for the end user.
allowed_kindsLimit the devices offered, for example glasses. Defaults to every kind.
requested_scopesCapability IDs or whole families such as present.*. At least one.
redirect_uriAn http or https URL the page returns to with the public_token.
brandingdisplay_name, logo_url and accent_color (#RRGGBB), over your project's saved branding.
| Status | Body |
|---|---|
201 | ConnectSessionCreateResponse |
400, 401, 403, 429 | Error |