Skip to main content
POST

Authorizations

​
Authorization
string
header
required

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

Headers

​
Idempotency-Key
string

Optional unique value (e.g. a UUID v4) that lets you safely retry POST/PUT/PATCH/DELETE requests. The first request runs normally; subsequent requests with the same key replay the stored response (status + body) for 24 hours, so retries can never double-create or double-charge. Two concurrent requests with the same key return 409 IDEMPOTENCY_IN_PROGRESS. Generate a fresh key per logical operation.

Maximum string length: 255

Body

application/json
​
addresses
string[]
required

Wallet addresses to import. Required and must be non-empty, even when rows is supplied: send the same addresses in both fields. EVM (0x...) and Solana addresses are accepted; invalid entries are skipped.

Minimum array length: 1
​
rows
object[]

Optional per-wallet first-party properties. When present and non-empty, the import uses these rows instead of addresses for the payload, so list the same wallets in both fields. Only the allowed profile keys are persisted (string values); unknown keys are ignored. Rows with an invalid address are skipped, and a request where no row has a valid address returns 400.

Response

Wallets imported successfully