ONontora
people

Import People

Changed on

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

Request

Query parameters

workspace_idstring uuid required
group_idsstring[]

Headers

X-API-Keystring nullable

Request body multipart/form-data

filestring binary required

Response

Successful Response

importedinteger required
updatedinteger required
skippedinteger required
errorsstring[]

Changes