Search/list contacts in a GoHighLevel location. Supports a free-text query (matches name, email, phone) and pagination. Returns matching contacts.

Fetch a single contact by id, including custom fields and tags.

Create a new contact. At least one of email or phone is recommended so the contact can be matched/deduplicated. Returns the created contact.

Update fields on an existing contact. Only provided fields are changed.

Add one or more tags to a contact without removing existing tags.

Permanently delete a contact. This is destructive and cannot be undone.

List all opportunity pipelines and their stages for a location. Use this to discover pipelineId and pipelineStageId values needed by other tools.

Search opportunities (deals) in a location. Filter by pipeline, stage, status, assigned user, or free-text query.

Fetch a single opportunity (deal) by id.

Create a new opportunity (deal) in a pipeline stage. Use ghl_get_pipelines first to obtain valid pipelineId and pipelineStageId values.

Update an opportunity: move stage, change status, value, name, or owner. Only provided fields are changed.

List calendars for a location. Use this to find a calendarId for booking and availability lookups.

Get available booking slots for a calendar within a date range. startDate and endDate are epoch milliseconds.

Book an appointment on a calendar for a contact. startTime/endTime are ISO 8601 strings (e.g. 2026-06-20T15:00:00-04:00). Use ghl_get_free_slots first.

Fetch a single calendar appointment/event by id.

Update an appointment's time or status (e.g. confirm, cancel, mark showed). Only provided fields are changed.

Delete a calendar event by its id. Works for both appointments and blocked time slots. Destructive and cannot be undone — to keep the record but mark it off, use ghl_update_appointment with appointmentStatus 'cancelled' instead.

Search conversations in a location, optionally filtered to a contact. Returns conversation threads with their ids and last-message info.

Fetch messages within a conversation thread, newest first. Use ghl_search_conversations to find a conversationId.

Send an outbound message to a contact via SMS or Email. For Email you must provide subject and html (or message as plain text). For SMS provide message. The contact must have a valid phone/email for the chosen channel.

List invoices for a location with pagination. Optionally filter by status (e.g. draft, sent, paid) and contact.

Fetch a single invoice by id, including line items and totals.

Create a draft invoice for a contact. Provide line items (name, qty, price). Business details are taken from GHL_BUSINESS_* env vars (or businessName/businessPhone overrides); contact details (name, phone, email, address) are auto-filled from the contact record. The invoice is created in draft status; use ghl_send_invoice to deliver it.

Send/deliver an existing invoice to the contact via the configured channel(s). This is outward-facing: it emails/texts the customer.

Void an invoice. Use this for invoices that have already been sent (which can no longer be deleted). Voiding cancels the invoice while keeping the record.

Delete an invoice. Only works while it is a draft — a sent invoice must be voided with ghl_void_invoice instead. Destructive and cannot be undone.

List the automation workflows configured in a location. Note: workflows must be built in the GoHighLevel UI; the API cannot create them. Use the returned workflow ids with ghl_add_contact_to_workflow to trigger automations.

Enroll a contact into an automation workflow, triggering it for that contact. Use ghl_list_workflows to find workflowId.

Remove a contact from an automation workflow, halting it for them.

List custom field definitions for a location. Filter by model (contact, opportunity, or all) to see which fields apply where. Use the returned ids when reading/writing custom field values on contacts.

Fetch a single custom field definition by id.

Create a custom field definition. For option-based types (SINGLE_OPTIONS, MULTIPLE_OPTIONS, RADIO, CHECKBOX) provide the options array.

Update a custom field definition. Only provided fields change.

Delete a custom field definition. Destructive: removes the field and its stored values across records.

List all tasks attached to a contact.

Fetch a single task on a contact by id.

Create a task on a contact. dueDate is ISO 8601 (e.g. 2026-06-20T17:00:00Z).

Update a task (e.g. mark completed, change due date or assignee). Only provided fields change.

Delete a task from a contact. Destructive.

List all notes logged on a contact, newest first.

Fetch a single note on a contact by id.

Add a note to a contact.

Update the text of an existing note on a contact.

Delete a note from a contact. Destructive.

List products in a location with pagination and optional search. Use the returned product ids when adding prices or building invoices/estimates.

Fetch a single product by id.

Create a product. After creating, add one or more prices with ghl_create_product_price so it can be used on invoices/estimates.

Update a product's fields. Only provided fields change.

Delete a product. Destructive.

List the prices configured for a product.

Add a price to a product. type 'one_time' for a single charge or 'recurring' for a subscription. amount is in the smallest practical unit of the currency as accepted by GHL (typically major units, e.g. 49.99).

List estimates (quotes) for a location with pagination. Optionally filter by status or contact.

Generate the next available estimate number for the location. Some accounts require an estimateNumber when creating an estimate — call this first.

Create an estimate (quote) for a contact with line items. If your account requires it, get estimateNumber from ghl_generate_estimate_number first. issueDate/expiryDate are YYYY-MM-DD.

Update an existing estimate. Pass the full set of items you want on the estimate (they replace the prior items). Only provided top-level fields change.

Send an estimate to the contact. Outward-facing: this emails/texts the customer.

Create an invoice from an accepted estimate, carrying over its line items.

Delete an estimate. Destructive.

List payment orders for a location with pagination. Optionally filter by status or contact. Use to see what was purchased and whether it was paid.

Fetch a single payment order by id, including line items and amounts.

List payment transactions for a location. Useful for reconciling revenue and spotting failed or refunded charges.

List recurring subscriptions for a location (e.g. retainers). Optionally filter by contact.

Fetch a single subscription by id.

List forms in a location. Use the returned form ids to fetch submissions.

Fetch submissions for a location's forms, optionally filtered to one form or a date range. Dates are YYYY-MM-DD.

List surveys in a location. Use the returned survey ids to fetch submissions.

Fetch submissions for a location's surveys, optionally filtered to one survey.

List users (team members) in a location. Use the returned ids as assignedTo / assignedUserId values when creating tasks, opportunities, or appointments.

Fetch a single user by id.

List funnels in a location. Optionally filter by type, category, or name.

List the pages within a funnel.

List calendar events/appointments within a time window. You must provide one of calendarId, userId, or groupId to scope the query. startTime/endTime are epoch milliseconds.

Block off time on a calendar so it can't be booked (e.g. a filming or edit day). startTime/endTime are ISO 8601 strings.

List notes attached to a calendar appointment.

Add a note to a calendar appointment (e.g. outcome of a shoot/call).

List the social media accounts connected to the location's Social Planner. Use the returned account ids when creating a post.

List scheduled/published social posts for the location. Optionally filter by account ids and a date range (ISO 8601).

Fetch a single social post by id.

Schedule or publish a social post to one or more connected accounts. Provide scheduleDate (ISO 8601) for a scheduled post; omit for an immediate draft per status. mediaUrls can include image/video URLs already hosted in GHL.

Delete a scheduled or draft social post. Destructive.

List files/folders in the location's Media Library with pagination, search, and optional type filter.

Add a file to the Media Library by referencing a publicly reachable URL (GHL fetches and hosts it). Good for deliverables or talent photos already available at a link. For raw binary uploads use the GHL UI.

Delete a file from the Media Library. Destructive.

List marketing campaigns in a location. Use a campaign id with ghl_add_contact_to_campaign.

Enroll a contact into a campaign, starting it for them.

Remove a contact from a campaign (or all campaigns if no id given).

List trackable trigger links in a location.

Create a trackable trigger link that redirects to a destination URL and can fire automations on click.

Delete a trigger link. Destructive.

List all tags defined in a location.

Create a new tag in the location's master tag list.

Rename an existing tag.

Delete a tag from the location. Destructive: removes it from records.

List location custom values (reusable merge fields used in templates/messages).

Fetch a single custom value by id.

Create a new custom value (merge field) with a name and value.

Update a custom value's name and/or value.

Delete a custom value. Destructive.

List business (company) records in a location.

Fetch a single business record by id.

Create a business (company) record.

Update a business record. Only provided fields change.

Delete a business record. Destructive.

List the custom object (and standard object) schemas defined in a location. Use the returned schema key with the record tools.

Fetch a custom object schema by key (e.g. custom_objects.podcast_episode), including its properties.

Search records of a custom object by a text query.

Fetch a single custom object record by id.

Create a record for a custom object. properties is a key/value map matching the schema's property keys.

Update a custom object record's properties.

Delete a custom object record. Destructive.

List association definitions in a location (the relationship types available between record kinds).

List the relations a given record participates in.

Create a relation between two records using an association definition. Get associationId from ghl_list_associations.

Delete a relation between two records. Destructive.