---
title: "Create Mapping"
method: POST
path: "/companies/{company_id}/sources/{source_id}/mappings"
tags: ["sources"]
---

# Create Mapping

`POST /companies/{company_id}/sources/{source_id}/mappings`

## Request

- Base URL: `https://app.zalster.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zalster.com/companies/{company_id}/sources/{source_id}/mappings`
- Auth: none declared

Create the next immutable mapping version.

Never edits an existing version. Re-posting an identical document returns the
version that already holds it rather than adding a duplicate.

## Path parameters

- `company_id` string, uuid, required: Company id
- `source_id` string, uuid, required: Source id

## Request body

- MappingCreate
  - `document` object, required
  - `notes` string, nullable
  - `activate` boolean

## Response `201`

Successful Response

- MappingVersionOut
  - `id` string, uuid, required
  - `source_id` string, uuid, required
  - `version` integer, required
  - `document` object, required
  - `document_hash` string, required
  - `notes` string, nullable, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zalster/apis/zalster-feed-processor.md) - [All operations](https://skmtc.dev/zalster/apis/zalster-feed-processor/llms.txt) - [OpenAPI document](https://skmtc.dev/zalster/apis/zalster-feed-processor/revisions/d0b9dc66ad36?raw)