Sign in

v4

latestOpenAPI 3.1.1Apache 2.02026-07-31107278570.4 KB
Connected Accounts

Verify connected account user

Confirms the user assertion and activates the connected account after the user completes third-party OAuth. Called by the B2B app server with auth_request_id and identifier. Validates that the asserted identifier matches the one stored on the auth request and promotes pending tokens to live.

post/api/v1/connected_accounts/user/verify

Request body

auth_request_idstring required

Auth request ID as base64url-encoded opaque token from the user verify redirect URL query params

identifierstring required

Current logged in user's connected account identifier

Example request

{
  "auth_request_id": "QVNDSUFyY2hhYml0dGVyXzE2ODQ5NzIwNzI0NTY=",
  "identifier": "user@example.com"
}

Response

Verification successful; connected account is now ACTIVE

post_user_verify_redirect_urlstring

URL to redirect the user to after successful verification

Example response

{
  "post_user_verify_redirect_url": "https://env1.example.com/connect/success"
}