link_account

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

Example

{ "name": "link_account", "arguments": { "type": "email", "identifier": "ada@old-mail.com" } }

Then, with the code the user received:

{ "name": "link_account", "arguments": { "ticket": "<ticket from step 1>", "code": "042518" } }

Getting Started

Authentication

Guides

Webhooks

Funding options

Withdrawals

MCP

Examples

Parameters

Returns

Example

​Parameters

​Returns

​Example

Parameters

Returns

Example