people

Import People

Import people records from a CSV file.

Expected columns: name, email, phone, job_title, department, seniority_level, type. Each row needs at least a name or an email. Rows are matched against existing people by email (per-workspace), so re-importing enriches instead of duplicating. Optional group_ids are assigned additively to every imported row.

seniority_level: a label (IC, Manager, Senior Manager, Director, VP, C-Level) or any custom label; bare numbers 1..6 are still accepted for back-compat. type: internal or external (omit to auto-classify by email domain).

Supports CSV and TSV. Max file size: 5MB. Max people: 10,000.

post/v1/people/import

Query parameters

workspace_idstring uuid required
group_idsstring[]

Headers

X-API-Keystring nullable

Response

Successful Response

importedinteger required
updatedinteger required
skippedinteger required
errorsstring[]

Changes

No recorded changes to this endpoint across all 1 revision of this API.