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

# gtm accounts

> Command reference for gtm accounts — GTM workflow commands. Contract: - Success data is always JSON on stdout. - Errors are always printed to stderr. - Mutating commands require --apply; default is preview/no-op. Generated from the CLI help text.

GTM workflow commands.

Contract:

* Success data is always JSON on stdout.
* Errors are always printed to stderr.
* Mutating commands require --apply; default is preview/no-op.

Every command follows the [CLI contract](/concepts/cli-contract): JSON on stdout, errors on stderr, and command-specific mutation safety controls. Keys resolve as described in [Secrets and API keys](/secrets).

## Examples

Research an objective, then preview a batch CRM load:

```bash theme={"system"} theme={"system"}
uv run gtm accounts research "Find competitors to Acme Corp"
```

```bash theme={"system"} theme={"system"}
uv run gtm accounts find-people "VP of Engineering at Series B startups"
```

```bash theme={"system"} theme={"system"}
# Preview (default): prints the planned writes, mutates nothing.
uv run gtm accounts batch-add-people \
  --records '[{"email": "jane@acme.dev", "first_name": "Jane", "last_name": "Doe"}]'
```

```json Output (preview) theme={"system"} theme={"system"}
{
  "mode": "preview",
  "requested": 1,
  "created": 0,
  "skipped": 1,
  "conflicts": 0,
  "errors": 0,
  "results": [{ "status": "would_create", "email": "jane@acme.dev" }],
  "source": "elvis.gtm.batch_add_people",
  "applied_at": null
}
```

Add `--apply` to the same command to perform the writes.

## Commands

### `gtm accounts research`

Run non-mutating research.

```bash theme={"system"}
uv run gtm accounts research [OPTIONS] [OBJECTIVE]
```

| Argument    | Type | Required |
| ----------- | ---- | -------- |
| `OBJECTIVE` | text | no       |

| Option               | Type | Default | Description                                       |
| -------------------- | ---- | ------- | ------------------------------------------------- |
| `--json`             | text | —       | JSON payload (overrides flags)                    |
| `--parallel-api-key` | text | —       | Override the Parallel API key for this invocation |

### `gtm accounts enrich`

Run non-mutating enrichment.

```bash theme={"system"}
uv run gtm accounts enrich [OPTIONS] [URL] [OBJECTIVE]
```

| Argument    | Type | Required |
| ----------- | ---- | -------- |
| `URL`       | text | no       |
| `OBJECTIVE` | text | no       |

| Option               | Type | Default | Description                                       |
| -------------------- | ---- | ------- | ------------------------------------------------- |
| `--json`             | text | —       | JSON payload (overrides flags)                    |
| `--parallel-api-key` | text | —       | Override the Parallel API key for this invocation |

### `gtm accounts find-people`

Run non-mutating people discovery.

```bash theme={"system"}
uv run gtm accounts find-people [OPTIONS] [QUERY]
```

| Argument | Type | Required |
| -------- | ---- | -------- |
| `QUERY`  | text | no       |

| Option               | Type | Default | Description                                       |
| -------------------- | ---- | ------- | ------------------------------------------------- |
| `--json`             | text | —       | JSON payload (overrides flags)                    |
| `--parallel-api-key` | text | —       | Override the Parallel API key for this invocation |

### `gtm accounts map-account-hierarchy`

Run non-mutating account hierarchy mapping.

```bash theme={"system"}
uv run gtm accounts map-account-hierarchy [OPTIONS] [ACCOUNT]
```

| Argument  | Type | Required |
| --------- | ---- | -------- |
| `ACCOUNT` | text | no       |

| Option               | Type | Default | Description                                       |
| -------------------- | ---- | ------- | ------------------------------------------------- |
| `--json`             | text | —       | JSON payload (overrides flags)                    |
| `--parallel-api-key` | text | —       | Override the Parallel API key for this invocation |

### `gtm accounts batch-add-people`

Batch add people with explicit preview/apply behavior.

```bash theme={"system"}
uv run gtm accounts batch-add-people [OPTIONS]
```

| Option            | Type    | Default | Description                                    |
| ----------------- | ------- | ------- | ---------------------------------------------- |
| `--records`       | text    | `""`    | JSON array of person records                   |
| `--apply`         | boolean | `false` | Perform writes to Attio                        |
| `--json`          | text    | —       | JSON payload (overrides flags)                 |
| `--attio-api-key` | text    | —       | Override the Attio API key for this invocation |

<Warning>
  Preview by default: without `--apply` this command prints the planned mutation and writes nothing. See the [CLI contract](/concepts/cli-contract).
</Warning>

### `gtm accounts batch-add-companies`

Batch add companies with explicit preview/apply behavior.

```bash theme={"system"}
uv run gtm accounts batch-add-companies [OPTIONS]
```

| Option            | Type    | Default | Description                                    |
| ----------------- | ------- | ------- | ---------------------------------------------- |
| `--records`       | text    | `""`    | JSON array of company records                  |
| `--apply`         | boolean | `false` | Perform writes to Attio                        |
| `--json`          | text    | —       | JSON payload (overrides flags)                 |
| `--attio-api-key` | text    | —       | Override the Attio API key for this invocation |

<Warning>
  Preview by default: without `--apply` this command prints the planned mutation and writes nothing. See the [CLI contract](/concepts/cli-contract).
</Warning>


## Related topics

- [gtm-sdk: Go-To-Market SDK and CLI for Modal](/index.md)
- [Launch week — gtm-sdk goes public (July 13, 2026)](/changelog/2026-07-13.md)
- [Quickstart: install gtm-sdk and run your first command](/quickstart.md)
- [CLI overview](/cli/index.md)
- [CLI contract](/concepts/cli-contract.md)