Link a user account with the provider's account using an id token

POST

/link/idtoken

• Nhost Authentication API Server

Link the authenticated user’s account with an external OAuth provider account using an ID token. Requires elevated permissions.

Authorizations

• BearerAuthElevated

Request Body ^required

ID token and provider information for account linking

object

provider

required

string

Allowed values: apple google

idToken

required

Apple ID token

string

nonce

Nonce used during sign in process

string

Responses

200

Identity linked successfully

string

Allowed values: OK

default

An error occurred while processing the request

Standardized error response

object

status

required

HTTP status error code

integer

Example

400

message

required

Human-friendly error message

string

Example

Invalid email format

error

required

Error code identifying the specific application error

string

Allowed values: default-role-must-be-in-allowed-roles disabled-endpoint disabled-user email-already-in-use email-already-verified forbidden-anonymous internal-server-error invalid-email-password invalid-request locale-not-allowed password-too-short password-in-hibp-database redirectTo-not-allowed role-not-allowed signup-disabled unverified-user user-not-anonymous invalid-pat invalid-refresh-token invalid-ticket disabled-mfa-totp no-totp-secret invalid-totp mfa-type-not-found totp-already-active invalid-state oauth-token-echange-failed oauth-profile-fetch-failed oauth-provider-error invalid-otp cannot-send-sms provider-account-already-linked