Profiles

Import wallet addresses

Import wallet addresses into the project as identified users. addresses is always required and must be non-empty; add rows to attach first-party properties to the same wallets. Imported wallets count toward monthly active user billing. Requires profiles:write scope and Scale/Enterprise plan.

post/v0/import

Request

  • Base URL: https://api.formo.so
  • URL: https://api.formo.so/v0/import
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

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.

Request body

addressesstring[] 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.

Response

Wallets imported successfully

Changes

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