---
title: "Unlink Auth"
method: POST
path: "/v1/auth/unlink"
tags: ["Authentication"]
---

# Unlink Auth

`POST /v1/auth/unlink`

Disconnect an authentication method or external wallet from the currently authenticated user. Provide the identifiers for the provider you want to remove (for example, an email address or wallet address) and this endpoint will detach it from the user's account.

**Usage:**
1. Choose the provider type you want to disconnect (email, phone, siwe, oauth, etc.)
2. Supply the provider-specific identifiers in the request body
3. Receive the updated list of linked authentication profiles

**Authentication:** Requires both client authentication (`x-client-id` or `x-secret-key`) and a wallet access token via `Authorization: Bearer <jwt>`.

## Request body

- object — Request body for unlinking an authentication provider or wallet from the currently authenticated user.
  - `type` 'apple' | 'coinbase' | 'discord' | 'email' | 'facebook' | 'farcaster' | 'github' | 'google' | 'guest' | 'line' | 'passkey' | 'phone' | 'siwe' | 'steam' | 'telegram' | 'twitch' | 'x' | 'tiktok' | 'epic' | 'backend' | 'wallet' | 'custom_auth_endpoint' | 'custom_jwt', required — Authentication provider type to disconnect
  - `details` object, required — Identifiers for the provider profile that should be disconnected
    - `address` string
    - `walletAddress` string — A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).
    - `email` string, email
    - `phone` string
    - `id` string
  - `allowAccountDeletion` boolean — If true, allows the account to be deleted when unlinking removes the last authentication method. Defaults to false when omitted.

## Response `200`

Authentication method unlinked successfully. The response contains the updated list of linked authentication profiles.

- object — Response returned after successfully linking an additional authentication provider. The response includes all linked profiles for the user.
  - `linkedAccounts` union[], required — Updated list of authentication profiles linked to the wallet after the new account has been connected.
    - union — Authentication provider details with type-based discrimination
      - object — Google OAuth authentication provider details
        - `email` string, required
        - `emailVerified` boolean, required
        - `familyName` string
        - `givenName` string
        - `hd` string, required
        - `id` string, required
        - `locale` string, required
        - `name` string
        - `picture` string, required
        - `type` 'google', required
      - object — Facebook OAuth authentication provider details
        - `email` string
        - `firstName` string
        - `id` string, required
        - `lastName` string
        - `name` string
        - `picture` string
        - `type` 'facebook', required
      - object — Apple OAuth authentication provider details
        - `email` string
        - `emailVerified` boolean, required
        - `id` string, required
        - `isPrivateEmail` boolean, required
        - `type` 'apple', required
      - object — GitHub OAuth authentication provider details
        - `avatar` string, nullable
        - `id` string, required
        - `name` string, nullable
        - `type` 'github', required
        - `username` string, required
      - object — Discord OAuth authentication provider details
        - `avatar` string, required
        - `email` string, email
        - `emailVerified` boolean, required
        - `id` string, required
        - `type` 'discord', required
        - `username` string, required
      - object — Coinbase OAuth authentication provider details
        - `avatar` string
        - `id` string, required
        - `name` string, required
        - `type` 'coinbase', required
      - object — X (Twitter) OAuth authentication provider details
        - `id` string, required
        - `name` string, required
        - `type` 'x', required
        - `username` string, required
        - `profileImageUrl` string
      - object — TikTok OAuth authentication provider details
        - `id` string, required
        - `displayName` string, required
        - `avatarUrl` string, required
        - `unionId` string
        - `type` 'tiktok', required
      - object — Epic Games OAuth authentication provider details
        - `id` string, required
        - `type` 'epic', required
        - `displayName` string
        - `email` string, email
        - `emailVerified` boolean
        - `metadata` object, required
          - `accountId` string, required
          - `preferredUsername` string
          - `country` string
          - `region` string
          - `language` string
          - `sub` string
          - `name` string
      - object — Steam OAuth authentication provider details
        - `avatar` string
        - `id` string, required
        - `metadata` object, required
          - `avatar` object, required
            - `large` string
            - `medium` string
            - `small` string
          - `personaname` string
          - `profileurl` string
          - `realname` string
        - `type` 'steam', required
        - `username` string
      - object — Telegram OAuth authentication provider details
        - `firstName` string
        - `id` string, required
        - `lastName` string
        - `picture` string
        - `type` 'telegram', required
        - `username` string
      - object — Twitch OAuth authentication provider details
        - `avatar` string
        - `description` string
        - `email` string
        - `id` string, required
        - `type` 'twitch', required
        - `username` string, required
      - object — LINE OAuth authentication provider details
        - `avatar` string
        - `id` string, required
        - `type` 'line', required
        - `username` string
      - object — Farcaster authentication provider details
        - `fid` string, required
        - `id` string, required
        - `type` 'farcaster', required
        - `walletAddress` string
      - object — Passkey authentication provider details
        - `algorithm` string, required
        - `credentialId` string, required
        - `publicKey` string, required
        - `type` 'passkey', required
      - object — Email authentication provider details
        - `email` string, email, required
        - `id` string, required
        - `type` 'email', required
      - object — Pre-generated wallet authentication provider details
        - `id` string, required
        - `pregeneratedIdentifier` string, required
        - `type` 'pre_generation', required
      - object — Phone authentication provider details
        - `id` string, required
        - `phone` string, required
        - `type` 'phone', required
      - object — Sign-In with Ethereum (SIWE) authentication provider details
        - `id` string, required
        - `type` 'siwe', required
        - `walletAddress` string, required
      - object — Guest authentication provider details
        - `id` string, required
        - `type` 'guest', required
      - object — Backend authentication provider details (deprecated, use server instead)
        - `id` string, required
        - `type` 'backend', required
      - object — Server authentication provider details
        - `identifier` string, required
        - `type` 'server', required
      - object — Custom JWT authentication provider details
        - `authProviderId` string
        - `email` string
        - `id` string, required
        - `phone` string
        - `type` 'custom_jwt', required
        - `walletAddress` string
      - object — Custom auth endpoint authentication provider details
        - `authProviderId` string
        - `email` string
        - `id` string, required
        - `phone` string
        - `type` 'custom_auth_endpoint', required
        - `walletAddress` string

## Other responses

- `400` — Invalid request parameters
- `401` — Wallet authentication required. Include Authorization: Bearer <jwt> header.
- `429` — Rate limit exceeded - Please wait before trying again
- `502` — Third-party provider did not return any linked accounts after processing the request.

---

[API](https://skmtc.net/thirdweb/apis/thirdweb-api.md) · [All operations](https://skmtc.net/thirdweb/apis/thirdweb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thirdweb/thirdweb-api/revisions/fb4cb67da1c7/schema)