Sign in
Identities

Complete linking an external identity

Exchanges the provider's authorization code (using the pending link identified by state) and links the verified identity to the signed-in user. The pending link is single-use and expires 10 minutes after it was started.

post/v1/identities/{provider}/link/complete

Path parameters

providerstring required
Example:world-sandbox

Request body

statestring required
codestring required

Response

Identity linked (or re-verified)

provider'clerk' | 'aep' | 'world' | 'world-sandbox' required
verifiedboolean required
firstLinkboolean required

True when this call created the identity link.

returnTostring

The returnTo supplied when the link was started.

Changes