> ## 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.

# Create mapping

> Create a saved CSV column mapping for batch imports — via the gu1 batch import API for high-volume data loading, with examples for create mapping use cases.

## Endpoint

```
POST https://api.gu1.ai/batch-import/mappings
```

## Overview

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

## Authentication

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Request Body

| Field             | Required | Description                                                                            |
| ----------------- | -------- | -------------------------------------------------------------------------------------- |
| `name`            | Yes      | Display name                                                                           |
| `target`          | Yes      | `transaction` \| `entity_person` \| `entity_company` \| `entity_mixed` \| `user_event` |
| `columnMapping`   | Yes      | Object: CSV column → Gu1 path or v2 spec                                               |
| `defaultFields`   | No       | e.g. default `countryCode` for entity targets                                          |
| `headersSnapshot` | No       | Reference header list                                                                  |

See also: [Bulk imports overview](/en/api-reference/bulk-imports/overview).