---
title: "Create Custom Field Mapping"
method: POST
path: "/api/v1/custom-fields/mapping"
tags: ["Custom Fields"]
---

# Create Custom Field Mapping

`POST /api/v1/custom-fields/mapping`

Create a custom field mapping. Provide exactly one of `integration_slug` (organization scope) or `connector_token` (connector scope).

## Request body

- CustomFieldMappingCreateExternal
  - `custom_field_id` string, uuid, required — ID of the custom field to be mapped.
  - `integration_slug` string, nullable — Integration slug — set this for an organization-scoped mapping (applies to all connectors of this integration in the org). Mutually exclusive with `connector_token`.
  - `connector_token` string, nullable — Connector token — set this for a connector-scoped mapping (applies to a single connector instance). Mutually exclusive with `integration_slug`.
  - `json_path` string, required — JMESPath expression to extract the value from the upstream payload.

## Response `201`

Successful Response

- object

## Other responses

- `401` — Missing or invalid bearer authentication credentials.
- `403` — The credentials are valid but do not permit access to this resource, e.g. a connector token used on a different API category or a model whose writes are disabled.
- `422` — Validation Error
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/bindbee/apis/bindbee-apis.md) · [All operations](https://skmtc.net/bindbee/apis/bindbee-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bindbee/bindbee-apis/versions/7da10dc93a21/schema)