Skip to main content
POST
/
batch-import
/
import
/
entities
Import entities (CSV)
curl --request POST \
  --url http://api.gu1.ai/batch-import/import/entities \
  --header 'Authorization: Bearer <token>'

Documentation Index

Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

POST https://api.gu1.ai/batch-import/import/entities

​
Overview

Content-Type: multipart/form-data. Validates the CSV, builds items, and enqueues the same bulk entity job as the dashboard. Success responses include a jobId. Permissions: entities:bulk_import. Product: organization flag bulk automatic entity import must be enabled.

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Form fields

FieldRequiredDescription
fileYesCSV file
mappingIdYesEntity mapping (entity_person, entity_company, or entity_mixed)
entityImportModeNoautomatic_enriched (default) or manual_no_enrichment
riskMatrixPersonIdNoUUID
riskMatrixCompanyIdNoUUID
skipRulesExecutionNotrue / false (default false)
stopOnFirstErrorNotrue / false
autoExecuteIntegrationsNoJSON string (automatic mode)
autoExecuteIntegrationsShareholdersNoJSON string
depthNoNumber 0–5
isClientNotrue / false
statusNoEntity status literal
attributesNoJSON string
nationalityNoISO2
monitoringNoJSON string
reportRecipientEmailsNoJSON array string
emailLocaleNoen / es / pt
See also: Bulk imports overview.