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_LIMIT_TENANT) waits the advertised Retry-After (up to 60 s) and sends that import again, naming the import holding the Team's write lock when the API names one; a longer wait fails. Needs Automate.

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_ID

Flags

FlagTypeRequiredDescription
--filestringyesThe file: a path, or - to read it from stdin (then --format is required).
--formatstringnocsv | json | ndjson. Default: from the file extension (.csv, .json, .ndjson).
--liststringnoAdd every imported Lead to this Lead list (cl_...).
--list-namestringnoAdd them to the list of this name (up to 100 characters), creating it. Not with --list.
--tagstringnoPut this Tag on every imported Lead (up to 64 characters); repeatable.
--remove-tagstringnoTake this Tag off every imported Lead; repeatable.
--apply-listsbooleannoAdd 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.
--mapstringnoMap a file header to a Lead field: header=target, for example "LinkedIn Profile=linkedin_url"; repeatable.
--delimiterstringnoA CSV's separator: comma, semicolon or tab. Default: found by the server.
--asyncbooleannoPrint 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-waitbooleannoSame 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.