Skip to main content
POST
/
recipients
/
{id}
/
destinations
Add a destination for a recipient
curl --request POST \
  --url https://api.platform.dakota.xyz/recipients/{id}/destinations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "destination_type": "crypto",
  "name": "My Ethereum Wallet",
  "crypto_address": "0x1234",
  "network_id": "ethereum-mainnet"
}
'
{
  "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi"
}

Authorizations

​
x-api-key
string
header
required

Headers

​
x-idempotency-key
string<uuid>
required

Unique key to ensure request idempotency. If the same key is used within a certain time window, the original response will be returned instead of executing the request again.

Path Parameters

​
id
string
required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

Body

application/json

Destination details.

Request for creating or updating a cryptocurrency destination.

​
destination_type
enum<string>
default:crypto
required

The type of destination.

Available options:
crypto
​
name
string
required

Name of the destination for reference

Example:

"My Ethereum Wallet"

​
crypto_address
string
required
Example:

"0x1234"

​
network_id
enum<string>
required

Identifier for a blockchain network

Available options:
ethereum-mainnet,
ethereum-sepolia,
ethereum-goerli,
ethereum-holesky,
solana-mainnet,
solana-devnet,
solana-testnet,
base-mainnet,
base-sepolia,
arbitrum-mainnet,
arbitrum-sepolia,
optimism-mainnet,
optimism-sepolia,
avalanche-mainnet,
avalanche-fuji,
polygon-mainnet,
polygon-amoy
Required string length: 1 - 30
Example:

"ethereum-mainnet"

Response

Destination created successfully.

Response containing a unique identifier.

​
id
string
required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"