Profiles

Update user properties

Set or unset first-party properties for a wallet profile. Override display name, email, socials, avatar, location, and other identity fields. Send null as a value to delete (unset) that property: the field then reads as null everywhere, including over any globally-enriched fallback value, until a new value is set. user_id cannot be unset (it participates in identity stitching). Set-and-unset compose in a single call. Note: profile enrichment snapshots are versioned, but first-party property overrides (and their deletions) are always current; a point-in-time read (timestamp) reflects the latest overrides, so a deletion also masks historical reads.

put/v0/profiles/{address}/properties

Request

  • Base URL: https://api.formo.so
  • URL: https://api.formo.so/v0/profiles/{address}/properties
  • 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

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

Properties updated. Returns the merged identity (the keys actually set, plus address + updated_at) so callers can cache without a follow-up read.

addressstring required
updated_atstring date-time required
user_idstring nullable
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

Changes

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