Import - Formo Docs

The formo import command group bulk imports wallet addresses into your project.

Requires profiles:write scope on your API key. This endpoint is available on Scale and Enterprise plans.

`formo import wallets`

Bulk import wallet addresses into the project.

Options

Option	Type	Required	Description
`--addresses`	`string`	❌	JSON array of wallet address strings to import
`--rows`	`string`	❌	JSON array of `{address, properties?}` objects for imports with profile properties
`--write-key`	`string`	❌	Deprecated and ignored; import now uses the project write key server-side

Provide exactly one of --addresses or --rows, with a non-empty array. The CLI rejects empty imports locally. When using --rows, it derives the required API addresses array from those rows.

Examples

# Import two wallet addresses
formo import wallets \
  --addresses '["0xabc123...","0xdef456..."]'

# Import wallets with profile properties
formo import wallets \
  --rows '[{"address":"0xabc123...","properties":{"display_name":"Alice"}}]'

# Import a list of addresses from a file
formo import wallets \
  --addresses "$(cat wallets.json)"

Tips

--addresses must be a JSON array of wallet address strings.
--rows must be a JSON array of objects with a non-empty address.
Use this command to backfill historical wallet addresses into your Formo project.

​formo import wallets

​Options

​Examples

​Tips

`formo import wallets`

Options

Examples

Tips