Profiles

Batch update user properties

Set first-party properties for up to 100 wallets in one request. Each item is a flat object with a required address (literal EVM 0x... or Solana; ENS names are NOT resolved here) plus any of the allowed profile keys. A null value unsets (deletes) that property (user_id cannot be unset); the reserved tombstone string _is_deleted is rejected as a value. Unknown keys are ignored; a row left with no valid keys, or with an invalid address, is quarantined (skipped and reported) rather than failing the batch. A request where every row is invalid returns 400. Requires profiles:write scope.

post/v0/profiles/properties

Request

Base URL: https://api.formo.so
URL: https://api.formo.so/v0/profiles/properties
Auth: HTTP bearer

Request body

addressstring required

Wallet address. Literal EVM (0x...) or Solana address only; ENS names are not resolved in batch requests.

user_idstring

display_namestring nullable

emailstring nullable

farcasterstring nullable

discordstring nullable

twitterstring nullable

telegramstring nullable

instagramstring nullable

websitestring nullable

githubstring nullable

linkedinstring nullable

facebookstring nullable

tiktokstring nullable

youtubestring nullable

redditstring nullable

avatarstring nullable

descriptionstring nullable

locationstring nullable

ensstring nullable

lensstring nullable

basenamesstring nullable

lineastring nullable

Response

Batch processed. Returns counts of forwarded vs quarantined rows, with a per-row errors entry for each quarantined row.

successful_rowsinteger required

Number of rows accepted and forwarded to ingest.

quarantined_rowsinteger required

Number of rows skipped (invalid address, or no valid keys).

Changes

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