> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# link_account

> Link or merge another Agentcard account that belongs to the same person.

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

**Behavior:** destructive.

## What it does

Link or merge another Agentcard account that belongs to the same person. Use when the user says they already have an account under a DIFFERENT email or phone number — most often after identity verification (KYC) is rejected as a duplicate, which means that person already verified on another account. Two steps: (1) call with \{ type, identifier } to send a one-time code to that email/phone; (2) call again with the \{ ticket, code } to verify. If the identifier belongs to a different account, the two accounts are MERGED (the identity-verified account survives and gains the other's email/phone, so both sign in to one account); if no account has it, it is simply added to the current account.

## Inputs

| Field | Type | Description |
| - | - | - |
| `type` | string: `email` · `phone` | Step 1: which kind of identifier the OTHER account uses. |
| `identifier` | string | Step 1: the email address or phone number of the other account to verify. |
| `ticket` | string | Step 2: the ticket returned by step 1. |
| `code` | string | Step 2: the one-time code the user received. |

## Returns

| Field | Type | Description |
| - | - | - |
| `message` *(required)* | string | Human-readable result or next step. |

## Example call

```json theme={null}
{
  "tool": "link_account",
  "arguments": {}
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.