Profiles

Add or update user labels

Upsert one or more labels for a wallet. Accepts either a single label object or an array of labels. Labels with the same tag_id (and chain_id, if provided) are overwritten. Requires profiles:write scope.

post/v0/profiles/{address}/labels

Request

  • Base URL: https://api.formo.so
  • URL: https://api.formo.so/v0/profiles/{address}/labels
  • Auth: HTTP bearer

Path parameters

addressstring required

Wallet address. Accepts an EVM (0x...) or Solana address, or an ENS name (e.g. vitalik.eth) which is resolved to an address.

Request body

OR

Response

Labels upserted. Single label in → bare UserLabel; array in → array of UserLabel. Echoes the normalised entries (lowercased tag_id; the caller-supplied timestamp when present, otherwise the server write time).

OR

Changes

No recorded changes to this operation across all 1 revision of this API.