create_object_schema
Create a new custom object schema with labels, key, and primary display property
This record as markdown: /tools/ghl/create-object-schema.md
What create_object_schema does on Ghl
AI agents use create_object_schema to create or update resources in Ghl, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Ghl environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | Yes | Unique key for the object (e.g., "custom_objects.pet"). The "custom_objects." prefix is added automatically if not included |
labels | object | Yes | Singular and plural names for the custom object |
locationId | string | — | Location ID (uses default if not provided) |
description | string | — | Description of the custom object |
primaryDisplayPropertyDetails | object | Yes | Primary property configuration for display |
Parameters from the server's own tool schema.
Why create_object_schema is rated Medium
This tool creates new configuration/schema objects in the GoHighLevel system. While it modifies the data structure, schema creation is typically reversible through deletion or modification, making it a Write rather than Destructive action.
From the tool's definition Tool description states 'Create a new custom object schema' which is a data creation operation. The verb 'create' and action of establishing a new schema constitute a reversible write operation.
Risk signalsHigh parameter count (10 properties)
Attacks that exploit this kind of access
The rule that runs create_object_schema safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Ghl, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For create_object_schema, this is the rule to start with:
create_object_schema stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Ghl, apply this rule, and every create_object_schema call is checked against it from then on.
Questions about create_object_schema
Create a new custom object schema with labels, key, and primary display property. It is categorised as a Write tool in the Ghl MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
create_object_schema accepts 5 parameters: key, labels, locationId, description, primaryDisplayPropertyDetails. Required: key, labels, primaryDisplayPropertyDetails. The full parameter table on this page comes from the server's own tool schema.
Register the Ghl MCP server in PolicyLayer and add a rule for create_object_schema: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Ghl. Nothing to install.
create_object_schema is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the create_object_schema rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for create_object_schema. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
create_object_schema is provided by the Ghl MCP server (ghl-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Ghl, and thousands of servers like it.
This server
Across the catalogue