---
title: "Update Custom Field Mapping"
method: PATCH
path: "/api/v1/custom-fields/mapping/{custom_field_mapping_id}"
tags: ["Custom Fields"]
---

# Update Custom Field Mapping

`PATCH /api/v1/custom-fields/mapping/{custom_field_mapping_id}`

Update a custom field mapping (json_path only).

## Path parameters

- `custom_field_mapping_id` string, uuid, required

## Request body

- CustomFieldMappingUpdateExternal
  - `json_path` string, required — JMESPath expression to extract the value from the upstream payload.

## Response `200`

Successful Response

- CustomFieldMappingExternal
  - `id` string, uuid, required — Unique identifier of the mapping.
  - `custom_field_id` string, uuid, required — ID of the custom field this mapping belongs to.
  - `integration_slug` string, nullable — Integration slug. Set when the mapping is organization-scoped; null otherwise.
  - `connector_token` string, nullable — Connector token. Set when the mapping is connector-scoped; null otherwise.
  - `json_path` string, required — JMESPath expression used to extract the value from the upstream payload.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable

## 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.
- `404` — The requested resource was not found.
- `422` — Validation Error
- `429` — Rate limit exceeded.

---

[API](https://skmtc.dev/bindbee/apis/bindbee-apis.md) · [All operations](https://skmtc.dev/bindbee/apis/bindbee-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bindbee/bindbee-apis/revisions/a2669930898c/schema)