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

> Bulk import wallet addresses into your Formo project from a CSV file or stdin using the CLI. Imported wallets are automatically enriched with onchain data.

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

<Note>
  Requires `profiles:write` scope on your API key. Only 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 |
| `--write-key` | `string` | ✅        | Project write SDK key                          |

### Examples

```bash theme={null}
# Import two wallet addresses
formo import wallets \
  --addresses '["0xabc123...","0xdef456..."]' \
  --write-key write_key_xxx

# Import a list of addresses from a file (using jq)
formo import wallets \
  --addresses "$(cat wallets.json)" \
  --write-key write_key_xxx
```

### Tips

* The `--addresses` value must be a valid JSON array of strings.
* Each string should be a valid wallet address (e.g. `0x…`).
* Use this command to backfill historical wallet addresses into your Formo project.