---
title: "POST /mapping/protocol"
method: POST
path: "/mapping/protocol"
tags: ["mapping"]
---

# POST /mapping/protocol

`POST /mapping/protocol`

Add mapping

## Request body

- MappingSchema
  - `correlation_mapping` object
  - `create_index` object
  - `create_table` string
  - `fields_mapping` object
  - `fields_settings` object
  - `guid` string
  - `hep_alias` string
  - `hepid` integer
  - `partid` integer
  - `partition_step` integer
  - `profile` string
  - `retention` integer
  - `schema_mapping` object
  - `schema_settings` object
  - `version` integer

## Response `201`

MappingCreateSuccessResponse

- MappingCreateSuccessResponse
  - `data` string
  - `message` string

## Other responses

- `400` — FailureResponse

## Changes

> 16 revisions in range; 1 could not be searched.

- **2021-11-03** `8b089db7394c` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-11-03** `31e15898198d` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-10-19** `2ab28454b40f` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-10-13** `b1f82f1cf2a3` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-10-13** `ee397eaefd08` — 8 info
  - the endpoint scheme security `+ name` was removed from the API
  - the endpoint scheme security `description` was removed from the API
  - the endpoint scheme security `schema` was removed from the API
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
  - …4 more

[Full history](https://skmtc.dev/sipcapture/apis/homer-app/changes/mapping/protocol/post.md)

---

[API](https://skmtc.dev/sipcapture/apis/homer-app.md) · [All operations](https://skmtc.dev/sipcapture/apis/homer-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipcapture/homer-app/revisions/2f261ecc6074/schema)