Skip to main content
POST
/
v0
/
profiles
/
{address}
/
labels
Create Label
curl --request POST \
  --url https://api.formo.so/v0/profiles/{address}/labels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tag_id": "<string>",
  "value": "<string>",
  "chain_id": "<string>",
  "source": "<string>"
}
'
{
  "success": true
}

Authorizations

​
Authorization
string
header
required

Workspace API key (e.g. formo_xxx). Create one in the Formo dashboard under Team Settings > API Keys.

Path Parameters

​
address
string
required

Wallet address (EVM 0x... or Solana base58)

Body

application/json
​
tag_id
string
required

Label identifier (lowercased on write). e.g. vip, airdrop_eligible, coinbase.verified_account

​
value
string

Optional label value (e.g. tier name, country code, points)

​
chain_id
string

Optional chain identifier the label applies to

​
source
string

Optional label source (defaults to 'import')

Response

Labels upserted

​
success
boolean