# Create Custom Field Folder

- **URL:** https://marketplace.gohighlevel.com/docs/ghl/custom-fields/create-custom-field-folder
- **Summary:** Create Custom Field Folder https://services.leadconnectorhq.com/custom-fields/folder Create Custom Field Folder The key for your custom object.

[Skip to main content](https://marketplace.gohighlevel.com/docs/ghl/custom-fields/create-custom-field-folder#__docusaurus_skipToContent_fallback)

Version: v3

Create Custom Field Folder
==========================

POST 

https://services.leadconnectorhq.com/custom-fields/folder

Copy for LLMView as MarkdownOpen in ClaudeOpen in ChatGPTOpen in Cursor

Create Custom Field Folder

info

Only supports Custom Objects and Company (Business) today. Will be extended to other Standard Objects in the future.

### Requirements

#### Scope(s)

`locations/customFields.write`

#### Auth Method(s)

`OAuth Access Token``Private Integration Token`

#### Token Type(s)

`Sub-Account Token`

Request[​](https://marketplace.gohighlevel.com/docs/ghl/custom-fields/create-custom-field-folder#request "Direct link to request")

### Header Parameters

**Version** stringrequired

**Possible values:** \[`v3`\]

API Version

*   application/json

*   Body
*   Example (auto)

### Body**required**

**objectKey**stringrequired

The key for your custom object. This key uniquely identifies the custom object. Example: "custom_object.pet" for a custom object related to pets.

**Example:** `custom_object.pet`

**name**stringrequired

Field name

**Example:** `Name`

**locationId**stringrequired

Location Id

**Example:** `ve9EPM428h8vShlRW1KT`

    {  "objectKey": "custom_object.pet",  "name": "Name",  "locationId": "ve9EPM428h8vShlRW1KT"}

Responses[​](https://marketplace.gohighlevel.com/docs/ghl/custom-fields/create-custom-field-folder#responses "Direct link to Responses")

*   201
*   400
*   401

Successful response

*   application/json

*   Schema
*   Example (auto)

**Schema**

**id**stringrequired

Unique identifier of the object

**objectKey**stringrequired

The key for your custom object. This key uniquely identifies the custom object. Example: "custom_object.pet" for a custom object related to pets.

**Example:** `custom_object.pet`

**locationId**stringrequired

Location Id

**Example:** `ve9EPM428h8vShlRW1KT`

**name**stringrequired

Field name

**Example:** `Name`

    {  "id": "string",  "objectKey": "custom_object.pet",  "locationId": "ve9EPM428h8vShlRW1KT",  "name": "Name"}

Bad Request

*   application/json

*   Schema
*   Example (auto)

**Schema**

**statusCode**number

**Example:** `400`

**message**string

**Example:** `Bad Request`

    {  "statusCode": 400,  "message": "Bad Request"}

Unauthorized

*   application/json

*   Schema
*   Example (auto)

**Schema**

**statusCode**number

**Example:** `401`

**message**string

**Example:** `Invalid token: access token is invalid`

**error**string

**Example:** `Unauthorized`

    {  "statusCode": 401,  "message": "Invalid token: access token is invalid",  "error": "Unauthorized"}

Share your feedback
-------------------

★★★★★

#### Authorization: Authorization

**name:** [Authorization](https://marketplace.gohighlevel.com/docs/ghl/custom-fields/custom-fields-v-2-api#authentication)
**type:** http**scopes:** `locations/customFields.write`**scheme:** bearer**bearerFormat:** JWT**in:** header**description:** Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

*   curl
*   nodejs
*   python
*   php
*   java
*   go
*   ruby
*   powershell

*   CURL

    curl -L 'https://services.leadconnectorhq.com/custom-fields/folder' \-H 'Content-Type: application/json' \-H 'Accept: application/json' \-H 'Authorization: Bearer <Authorization>' \-d '{  "objectKey": "custom_object.pet",  "name": "Name",  "locationId": "ve9EPM428h8vShlRW1KT"}'

RequestCollapse all

Base URL

Edit

https://services.leadconnectorhq.com

Auth

Bearer Token

Parameters

Version — headerrequired\---v3

Body required

{
  "objectKey": "custom_object.pet",  "name": "Name",  "locationId": "ve9EPM428h8vShlRW1KT"
}
Send API Request

ResponseClear

Click the `Send API Request` button above and see the response here!