> ## Documentation Index
> Fetch the complete documentation index at: https://docs.formo.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Import

> Import wallet addresses with the Formo CLI and enrich them with onchain data and first-party profile properties.

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

<Note>
  Requires `profiles:write` scope on your API key. This endpoint is available on **Scale** and **Enterprise** plans.
</Note>

## `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

```bash theme={null}
# 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.