v4

latestOpenAPI 3.1.02026-08-01139149645.9 KB

Custom Fields

Create Custom Field Mapping

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

post/api/v1/custom-fields/mapping

Request body

custom_field_idstring uuid required

ID of the custom field to be mapped.

integration_slugstring 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_tokenstring nullable

Connector token — set this for a connector-scoped mapping (applies to a single connector instance). Mutually exclusive with integration_slug.

json_pathstring required

JMESPath expression to extract the value from the upstream payload.

Example request

{
  "custom_field_id": "018e586b-7d0b-7bc9-be65-a8fdbc82d734",
  "integration_slug": "workday",
  "connector_token": "i5kqe8bSedEdPLX9pHhFojKdo7Uzvue0f7I4NVhaDfV0GTxF0uAgwa_COb3zZU3T"
}

Response

Successful Response

object required