Skip to main content
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

OptionTypeRequiredDescription
--addressesstring❌JSON array of wallet address strings to import
--rowsstring❌JSON array of {address, properties?} objects for imports with profile properties
--write-keystring❌Deprecated and ignored; import now uses the project write key server-side
Provide either --addresses or --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.