curviate lead import
Import Leads from a CSV, JSON (an array of objects) or NDJSON file. The format comes from the extension; with --file - pass --format. A file above 10000 rows or 9 MiB is split into several imports, run one after the other (a CSV's header is repeated), each awaited unless --async (or --no-wait); the first refused or failed import stops the run. Only the file's structure is checked here; the server skips bad rows and reports why. Re-importing merges: a Lead already there is updated or left as it is. If the request times out or the connection drops, the CLI looks up the Team's newest imports, again every 2 s for up to 30 s while none shows, and reports the one this request made (id and status; it waits on a running one); it says nothing was imported only when none appeared. A busy-Team 429 (RATE_
Usage
curviate lead import --file <file> [flags]Examples
curviate lead import --file prospects.csv --list-name "Q4 prospects" --tag conference
curviate lead import --file leads-export.csv --apply-lists --async
curviate lead import --file - --format ndjson --list cl_YOUR_LIST_IDFlags
| Flag | Type | Required | Description |
|---|---|---|---|
--file | string | yes | The file: a path, or - to read it from stdin (then --format is required). |
--format | string | no | csv | |
--list | string | no | Add every imported Lead to this Lead list (cl_...). |
--list-name | string | no | Add them to the list of this name (up to 100 characters), creating it. Not with --list. |
--tag | string | no | Put this Tag on every imported Lead (up to 64 characters); repeatable. |
--remove-tag | string | no | Take this Tag off every imported Lead; repeatable. |
--apply-lists | boolean | no | Add each Lead to the Lead lists named in its lists (an export's column), creating a missing list by name. Only adds. A row past the Team's list limit is skipped (list_limit_reached). Default: the column is ignored. |
--map | string | no | Map a file header to a Lead field: header=target, for example "LinkedIn Profile=linkedin_url"; repeatable. |
--delimiter | string | no | A CSV's separator: comma, semicolon or tab. Default: found by the server. |
--async | boolean | no | Print the imports' ids as soon as each is accepted and exit 0, without waiting for them to finish; follow one with curviate lead imports get IMPORT_ID. Stops only on a refused request. |
--no-wait | boolean | no | Same as --async. |
Also accepts these global flags: --api-key, --profile, --account, --team, --base-url, --timeout, --json, --fields, --preview, --verbose, --beta.
Exit codes: the exit code table. More commands: Lead.