Preview a contacts import file before running it

POST 
/api/contacts/import/preview

Parses the header row plus a small sample (~20 rows) and classifies every column: built-in, an existing custom field, or unknown. Unknown columns carry a suggestion (slug key + a type guessed from the sample values) so the panel can offer "add as custom field" or "ignore" before the real import. The file is not stored — re-send it (with the decisions) to POST /api/contacts/import. Requires the contacts-manage permission.

Request

Responses

200

The per-column classification.

401

Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).

403

Authenticated but not allowed.

422

The request failed validation.