Skip to main content
PUT
Update user properties

Authorizations

Authorization
string
header
required

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

Path Parameters

address
string
required

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

Body

application/json

Merge-update of profile properties. Only the listed keys are accepted; unknown keys are rejected. At least one key must be provided.

user_id
string
display_name
string
email
string
farcaster
string
discord
string
twitter
string
telegram
string
instagram
string
website
string
github
string
linkedin
string
facebook
string
tiktok
string
youtube
string
reddit
string
avatar
string
description
string
location
string
ens
string
lens
string
basenames
string
linea
string

Response

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

Echo of the wallet identity after the merge-update applied. Synthesised from the request payload; analytics ingestion is eventually consistent, so the response reflects the applied write rather than a follow-up read.

address
string
required
updated_at
string<date-time>
required
user_id
string | null
display_name
string | null
email
string | null
farcaster
string | null
discord
string | null
twitter
string | null
telegram
string | null
instagram
string | null
website
string | null
github
string | null
linkedin
string | null
facebook
string | null
tiktok
string | null
youtube
string | null
reddit
string | null
avatar
string | null
description
string | null
location
string | null
ens
string | null
lens
string | null
basenames
string | null
linea
string | null