---
title: "Create mapping"
method: POST
path: "/v2/mapping/groups/{domainGroupId}"
tags: ["Mappings"]
---

# Create mapping

`POST /v2/mapping/groups/{domainGroupId}`

## Path parameters

- `domainGroupId` integer, required

## Request body

- MappingMappingRequest
  - `quinyxValue` string, required
  - `externalValue` string, required
  - `mappingType` 'GROUP_ID' | 'EMPLOYEE_ID' | 'ABSENCE_ID' | 'UNIT_ID' | 'SECTION_ID' | 'ROLE_ID' | 'AGREEMENT_TEMPLATE_ID' | 'AGREEMENT' | 'DISTRICT_ID'
  - `parentId` integer

## Response `201`

Response for the created mapping of quinyxValue and externalValue

- MappingMappingResponse
  - `mappingType` string
  - `id` string
  - `quinyxValue` string
  - `externalValue` string
  - `domainId` integer

## Other responses

- `400` — In case when quinyxValue or externalValue are invalid
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `501` — Mapping type not supported

---

[API](https://skmtc.net/quinyx/apis/quinyx-api.md) · [All operations](https://skmtc.net/quinyx/apis/quinyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quinyx/quinyx-api/revisions/70a12bbb88c9/schema)