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
- 401
- 403
- 422
The per-column classification.
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).
Authenticated but not allowed.
The request failed validation.