Unlinking server-side

Make a POST request to:

https://auth.privy.io/api/v1/apps/<privy-app-id>/users/unlink

Replace <privy-app-id> with your Privy app ID and pass in the following parameters:

Parameter	Type	Description
`user_id`	`string`	Privy DID of the user
`type`	`string`	Linked account type (see supported types below)
`handle`	`string`	The identifier for the account (e.g., email address, wallet address)

Supported Account Types

The following account types can be unlinked via the API:

email - Email accounts
phone - Phone number accounts
wallet - Externally connected wallets (Ethereum or Solana)
smart_wallet - Smart contract wallets
farcaster - Farcaster accounts
telegram - Telegram accounts
OAuth providers:
- google_oauth
- discord_oauth
- twitter_oauth
- github_oauth
- linkedin_oauth
- apple_oauth
- spotify_oauth
- instagram_oauth
- tiktok_oauth

The API does not support unlinking passkey, custom_auth, or guest account types.

Example Requests

curl --request POST "https://auth.privy.io/api/v1/apps/<privy-app-id>/users/unlink" \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H 'Content-Type: application/json' \
-d '{
  "user_id": "<user-did>",
  "type": "email",
  "handle": "[email protected]"
}'

curl --request POST "https://auth.privy.io/api/v1/apps/<privy-app-id>/users/unlink" \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H 'Content-Type: application/json' \
-d '{
  "user_id": "<user-did>",
  "type": "wallet",
  "handle": "0x1234...5678"
}'

curl --request POST "https://auth.privy.io/api/v1/apps/<privy-app-id>/users/unlink" \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H 'Content-Type: application/json' \
-d '{
  "user_id": "<user-did>",
  "type": "google_oauth",
  "handle": "<subject-identifier>"
}'

Response

If the unlinking is successful, the API will return a 200 status code.If there’s no account associated with the Privy DID that matches the type and handle, the API will return a 400 status code.

Users

User management

Managing users

Migrating users to Privy

Webhooks

Unlinking server-side

Unlinking Methods

Supported Account Types

Example Requests

Response

​Unlinking Methods

​Supported Account Types

​Example Requests

​Response

Unlinking Methods

Supported Account Types

Example Requests

Response