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

- **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
- **2021-10-09** `a5730259529b` — 5 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
  - the security scope `apiKey` was added to the endpoint's security scheme `type`
  - the security scope `header` was added to the endpoint's security scheme `in`
  - the security scope `MappingSchema` was removed from the endpoint's security scheme `type`
  - …1 more
- **2021-10-08** `d39f8246865f` — 12 info
  - the endpoint scheme security `+ name` was added to the API
  - the endpoint scheme security `SecurityDefinitions` was added to the API
  - the endpoint scheme security `description` was added to the API
  - the endpoint scheme security `in` was added to the API
  - …8 more
- **2020-04-01** `8739183b4c43` — 1 info
  - endpoint added
- **2020-01-12** `52987c8da72a` — 1 breaking
  - api path removed without deprecation

[Change 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/ee397eaefd08/schema)