Connections
Start connecting a provider
POST
Returns the provider's consent URL. Send the user there; after consent the user
lands on redirect_uri?status=connected|error&provider=<slug>, or on a built-in
result page when no redirect_uri is given. Each call mints a fresh single-use state;
Idempotency-Key is not honoured here. While the user's data from this provider is
being deleted the answer is 409: connect again once the deletion job is done.
tenantKeyheader
AuthorizationBearer <token>Tenant API key, ohs_sk_ + 43 base62 characters.
id*stringFormat
uuidprovider*stringConnector slug, see GET /v1/providers.
application/json- body
redirect_uri?stringFormat
uriConsent URL.
application/json- response
authorize_url*stringFormat
uricurl -X POST 'http://localhost:8080/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/connections/withings' \ -H 'Authorization: Bearer ohs_sk_...' \ -H 'Content-Type: application/json' \ -d '{}'{ "authorize_url": "http://example.com"}