Skip to main content
POST
/
batch-import
/
mappings
Create mapping
curl --request POST \
  --url http://api.gu1.ai/batch-import/mappings \
  --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/mappings

​
Overview

Creates a new mapping. Response { mapping: { ... } } with status 201 on success.

​
Authentication

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
Request body

FieldRequiredDescription
nameYesDisplay name
targetYestransaction | entity_person | entity_company | entity_mixed | user_event
columnMappingYesObject: CSV column → Güeno path or v2 spec
defaultFieldsNoe.g. default countryCode for entity targets
headersSnapshotNoReference header list
See also: Bulk imports overview.