Search contacts in GoHighLevel by query, tags, filters, or custom fields. Returns paginated results.

Args:

• query (string): Search term (name, email, phone)

• locationId (string): Location ID (uses default if omitted)

• limit (number): Results per page (1-100, default 20)

• filters (object): Advanced filters like tags, date ranges, custom fields

Returns: List of contacts with pagination metadata.

Get a single contact by ID with all details including custom fields, tags, and activity.

Create a new contact in GoHighLevel.

Args:

• firstName, lastName, email, phone (strings): Basic contact info

• tags (string[]): Tags to apply

• source (string): Lead source

• customFields (array): Custom field values as [{id, field_value}]

• locationId (string): Location ID (uses default if omitted)

Returns: Created contact object with ID.

Update an existing contact. Only pass fields you want to change.

Permanently delete a contact. This cannot be undone.

Create or update a contact by email/phone. If a match is found, updates; otherwise creates new.

Add one or more tags to a contact.

Remove one or more tags from a contact.

Get all notes for a contact.

Add a note to a contact.

Delete a specific note from a contact.

Get all tasks for a contact.

Create a task for a contact.

Update an existing task for a contact.

Add a contact to a GHL workflow/automation.

Remove a contact from a GHL workflow.

Search conversations by contact ID, query, or status. Returns threaded conversations with latest message info.

Get a single conversation by ID with metadata.

Get messages in a conversation thread. Returns SMS, email, and other message types.

Send a message (SMS, Email, WhatsApp, or other) to a contact via GoHighLevel.

Args:

• type: "SMS", "Email", "WhatsApp", "GMB", "IG", "FB", "Custom", "Live_Chat"

• contactId: The recipient contact ID

• message: The message body (text for SMS/WhatsApp, HTML for email)

• subject: Email subject (required for Email type)

• emailFrom: Sender email (for Email type)

• html: HTML body (for Email type, alternative to message)

• scheduledTimestamp: ISO timestamp to schedule future send

Returns: Sent message object with ID and status.

Cancel a previously scheduled message.

Update conversation status (starred, unread, etc.).

Get all calendars for the location.

Get details of a specific calendar.

Get available booking slots for a calendar within a date range.

Get appointments/events for a location, optionally filtered by calendar, contact, or date range.

Create a new appointment/event on a GHL calendar.

Update an existing appointment/event.

Delete/cancel an appointment.

Create a new calendar in GoHighLevel.

Search opportunities (deals) by pipeline, stage, status, contact, or monetary value.

Get details of a specific opportunity/deal.

Create a new opportunity/deal in a pipeline.

Update an existing opportunity — move stages, change value, update status, etc.

Permanently delete an opportunity.

Change the status of an opportunity (open, won, lost, abandoned).

Get all pipelines and their stages for a location.

Get payment orders for a location.

Get details of a specific payment order.

Get payment transactions for a location.

Get active subscriptions for a location.

Get invoices for a location. Filter by status, contact, or date range.

Get details of a specific invoice.

Create a new invoice for a contact.

Send an invoice to the contact via email.

Void an existing invoice.

Get all workflows/automations for a location.

Get all custom fields for contacts in a location.

Create a new custom field for contacts.

Get details of a GHL location/sub-account including settings, address, and configuration.

Get all tags defined in a location.

Create a new tag in the location.

Search for users/team members in a location.

Get all forms for a location.

Get submissions for forms in a location.

Get all surveys for a location.

Get all campaigns for a location.

Get scheduled and published social media posts.

Schedule or publish a social media post.

Get all connected social media accounts (Facebook, Instagram, Google, etc.).

Get all funnels/websites for a location.

Get all products for a location.

Get all blogs for a location.

Get all trigger links for a location.