Skip to main content
Bulk-import the contacts in a dataset into the active account under a tag. Start an import, read a snapshot of its progress, or block until it reaches a terminal phase.
contacts-import is a platform-mode command. Before running it:
  1. landbase-cli auth login — authenticate the session.
  2. landbase-cli account set — pick and persist the target account.
  3. Have a datasetId from a prior search or agent run — the CLI does not produce datasets, so run a search/agent flow first.
Without an active account the command exits with No account id...; pass --account=<id> per call as an escape hatch.

​
contacts-import start

Start an import. Reads a JSON body — { datasetId, tagName, importId? } — and enqueues processing in one call. Pass - to read the body from stdin. Returns { importId, runRef }. With --watch, the command stays attached, polls until the import is terminal, and writes the final status to stdout instead of the start response. Usage
​
--json
string
required
Path to a JSON file with the import body, or - to read it from stdin. Body shape: { "datasetId": "<dataset-id>", "tagName": "Q2 outreach", "importId"?: 7 }. datasetId and tagName (1–100 chars) are required; importId resumes an existing draft.
Flags

​
contacts-import status

Read one status snapshot. Designed for scripts that drive their own polling loop. Usage
​
importId
integer
required
The import id returned by contacts-import start.
Prints a lean, stable shape — { importId, phase, percent, counts, error } — where keys are present in every phase and null until known. See output schemas.

​
contacts-import wait

Block until the import is terminal, then print the final status to stdout. Runs the same polling loop as start --watch, streaming a progress line to stderr per poll. Backoff schedule: 5s, 10s, then a 20s cap; overall timeout 30 minutes. Usage
​
importId
integer
required
The import id to wait on.
Prefer wait (or start --watch) over an external polling loop unless you need a custom cadence. Avoid sub-second polling — it won’t return results faster and may trip rate limits.

​
Phases

phase is the value to branch on. The import is done once it reaches a terminal phase.

​
Errors

​
Examples