API Reference

Create a recipient

posthttps://api-sandbox.circle.com/v1/addressBook/recipients

  • Reference
  • Playground
Body parameters
metadata
object
Required
nickname
string

Nickname related to the address.

email
string

Email of the user.

bns
string

Blockchain Name Service (e.g. ENS) domain for the address.

address
string
Required

An alphanumeric string representing a blockchain address. Will be in different formats for different chains. It is important to preserve the exact formatting and capitalization of the address.

chain
string
Required

The blockchain network to use for the address.

Allowed valuesARBAVAXBASEBTCCELOETHNEARNOBLEOPPAHPOLYSOLSUIXLM
idempotencyKey
string
Required

Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests.

addressTag
string

The secondary identifier for a blockchain address. An example of this is the memo field on the Stellar network, which can be text, id, or hash format.

Response
RequestChoose a language
ResponseChoose an example
1{
2  "data": {
3    "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
4    "chain": "ALGO",
5    "address": "0x8381470ED67C3802402dbbFa0058E8871F017A6F",
6    "addressTag": "123456789",
7    "metadata": {
8      "nickname": "sample nickname",
9      "email": "[email protected]",
10      "bns": "sample.circle"
11    },
12    "status": "pending",
13    "createDate": "2020-04-10T02:13:30.000Z",
14    "updateDate": "2020-04-10T02:13:30.000Z"
15  }
16}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.