thirdwebDocs
Wallets

Linking Profiles

thirdweb Wallets allow users to tie the same wallet address to multiple social identities. Developers can programmatically link additional identities at any point in their user journey.

Link an additional authentication method to an existing wallet.

POST
/v1/auth/link
fetch("https://api.thirdweb.com/v1/auth/link", {
method: "POST",
headers: {
"x-client-id": "<your-project-client-id>",
},
body: {
accountAuthTokenToConnect: "tw_acc_auth_token_123",
},
});
{
"linkedAccounts": [
{
"id": "auth_siwe_123",
"type": "siwe",
"walletAddress": "0x742d35Cc6634C0532925a3b8D43C67B8c8B3E9C6"
}
]
}

Remove a linked authentication method from a wallet.

POST
/v1/auth/unlink
fetch("https://api.thirdweb.com/v1/auth/unlink", {
method: "POST",
headers: {
"x-client-id": "<your-project-client-id>",
},
body: {
type: "siwe",
details: {
address: "0x742d35Cc6634C0532925a3b8D43C67B8c8B3E9C6",
},
},
});
{
"linkedAccounts": [
{
"id": "auth_siwe_123",
"type": "siwe",
"walletAddress": "0x742d35Cc6634C0532925a3b8D43C67B8c8B3E9C6"
}
]
}

Retrieve Linked Profiles

Once linked, you can retrieve the user profiles via either identity.

Retrieve linked profiles using the Fetch Users API.

For fetching linked profile information from the backend, see Fetch Users.