v4

latestOpenAPI 3.1.02026-08-03427198448.4 KB
Client Enrichment

Finalize Contact Import

Finalize an imported contact batch and trigger guarded auto-enrichment.

Trust boundary: LinkedIn/Google browser import modals currently insert contacts directly through Supabase, so the backend cannot write a receipt in the same commit. For a receipt not already written by a server import path, this endpoint creates it only after proving every supplied contact belongs to the authenticated organization and has created_at within the last 24 hours. That recency window limits which direct-client writes may be claimed as an import; it is not proof that the browser performed the original insert.

post/api/contacts/import-finalize

Query parameters

user_idstring
org_idstring

Request body

import_batch_idstring uuid nullable
sourcestring required
contact_idsstring[] required

Response

Successful Response

receipt_idstring required
statusstring required
job_idstring nullable
createdboolean nullable
reasonstring nullable
requested_countinteger required
granted_countinteger required