> ## 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.

Links another email or phone number to the user's account. If that identifier belongs to a different Agentcard account, the two accounts **merge** into one (the identity-verified account survives, and both identifiers sign in to it afterwards); if nothing uses it, the identifier is simply added.

The main use is the duplicate identity rejection from [get\_kyc\_status](/companies/mcp/tools/get_kyc_status): the person already verified on an account with a different email or phone, so the fix is linking that account, never re-submitting documents. It runs in two steps: call with `type` + `identifier` to send a one-time code to that email or phone, then call again with the returned `ticket` and the `code` the user reads back.

## Parameters

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

## Returns

Step 1 confirms the code was sent and returns the `ticket` to pass back. Step 2 reports the outcome: the accounts were **merged** (cards, wallet, identity verification, and history now live on one account) or the identifier was **added** to the current account. If **both** accounts have completed identity verification the merge is refused (`both_kyc_approved`); that case goes to [support@agentcard.sh](mailto:support@agentcard.sh).

## Example

```json theme={null}
{ "name": "link_account", "arguments": { "type": "email", "identifier": "ada@old-mail.com" } }
```

Then, with the code the user received:

```json theme={null}
{ "name": "link_account", "arguments": { "ticket": "<ticket from step 1>", "code": "042518" } }
```