---
title: "Create Ghl Mapping"
method: POST
path: "/integrations/ghl/mappings"
tags: ["GoHighLevel"]
---

# Create Ghl Mapping

`POST /integrations/ghl/mappings`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/integrations/ghl/mappings`
- Auth: none declared

## Request body

- GhlFieldMappingCreate: Create a lead → GHL custom-field mapping
  - `ghl_field_id` string, required
  - `ghl_field_key` string, nullable
  - `ghl_field_name` string, nullable
  - `ghl_field_data_type` string, nullable
  - `ghl_field_model` string
  - `picklist_options` string[], nullable
  - `source_type` 'lead_field' | 'constant' | 'ai', required
  - `source_key` string
  - `constant_value` string, nullable
  - `enabled` boolean
  - `extraction_instructions` string
  - `overwrite_existing` boolean
  - `display_order` integer

## Response `200`

Successful Response

- GhlFieldMappingItem: One configured lead → GHL custom-field mapping
  - `ghl_field_mapping_id` string, uuid, required
  - `ghl_field_id` string, required
  - `ghl_field_key` string, nullable
  - `ghl_field_name` string, nullable
  - `ghl_field_data_type` string, nullable
  - `ghl_field_model` string
  - `picklist_options` string[], nullable
  - `source_type` 'lead_field' | 'constant' | 'ai', required
  - `source_key` string
  - `constant_value` string, nullable
  - `enabled` boolean
  - `extraction_instructions` string
  - `overwrite_existing` boolean
  - `display_order` integer

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-17** `0afcd7c31ce2`: 1 breaking, 3 warning, 9 info
  - request property `source_type` was restricted to a list of enum values
  - added the new `ai` enum value to the `source_type` response property for the response status `200`
  - added the new `constant` enum value to the `source_type` response property for the response status `200`
  - added the new `lead_field` enum value to the `source_type` response property for the response status `200`
  - …9 more

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/integrations/ghl/mappings/post.md)

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/de90a8dcbc07?raw)