Skip to main content
POST
/
v2
/
accounts
/
link
Link account to CDP for the current entity
curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/accounts/link \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
  "type": "business"
}'
{
  "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
  "type": "business",
  "linked": true
}

Body

application/json
​
accountId
string
required

The ID of the Account, which is a UUID prefixed by the string account_.

Example:

"account_af2937b0-9846-4fe7-bfe9-ccc22d935114"

​
type
enum<string>
required

The type of account being linked (business or prime).

Available options:
business,
prime
Example:

"business"

Response

Account linked successfully.

​
accountId
string
required

The ID of the Account, which is a UUID prefixed by the string account_.

Example:

"account_af2937b0-9846-4fe7-bfe9-ccc22d935114"

​
type
enum<string>
required

The type of account being linked (business or prime).

Available options:
business,
prime
Example:

"business"

​
linked
boolean
required

Indicates whether the link was successful.

Example:

true