GActionGoHighLevelUpdated May 2026

How do I add a contact to GoHighLevel?

Short answer: Drop the "GoHighLevel → Create GoHighLevel Contact" action anywhere in your workflow, map the inputs from upstream nodes, and publish.

Use this action All 9 GoHighLevel actions

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

Field	Type	Required	Description
Location ID locationId	string	Required	The GoHighLevel sub-account (location) the contact belongs to.
Email email	string	Optional	Email. e.g. "user@example.com"
Phone phone	string	Optional	Phone in E.164 format. e.g. "+15551234567"
First Name firstName	string	Optional	First Name. e.g. "Jane"
Last Name lastName	string	Optional	Last Name. e.g. "Smith"
Company companyName	string	Optional	Company Name. e.g. "Acme Inc"
Source source	string	Optional	Where this contact came from (used in GoHighLevel reporting). e.g. "Website Form"
Tags tags	string	Optional	Comma-separated tags to apply on creation.

Sample request

{
  "locationId": "e.g. ve9EPM428h8vShlRW1KT",
  "email": "user@example.com",
  "phone": "+15551234567",
  "firstName": "Jane",
  "lastName": "Smith"
}

Returns

{
  "contact": {
    "id": "ocQHyuzHvysMo5N5VsXc",
    "tags": [
      "newsletter",
      "lead"
    ],
    "email": "jane@example.com",
    "phone": "+15551234567",
    "source": "Website Form",
    "lastName": "Smith",
    "dateAdded": "2026-04-11T10:00:00.000Z",
    "firstName": "Jane",
    "locationId": "ve9EPM428h8vShlRW1KT",
    "companyName": "Acme Inc"
  }
}

Use these fields in downstream nodes for routing, logging, or error handling.

Triggered by

Apps that pair well as the trigger for Create GoHighLevel Contact.

Any of these apps can fire this action as part of a workflow.

Google Sheets → GoHighLevel

2 Google Sheets triggers

HubSpot → GoHighLevel

18 HubSpot triggers

FAQ

Questions about Create GoHighLevel Contact.

What does the Create GoHighLevel Contact action do in GoHighLevel?

Inserts a contact with email, name, phone, custom fields, and starting tags. The base hook for "form submission → push to GHL" sync workflows in agency-managed sub-accounts.

What inputs does Create GoHighLevel Contact require?

Required: Location ID. Every input accepts a static value or a variable from any upstream node in your workflow.

Can I use dynamic inputs from earlier workflow nodes?

Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.

What happens if GoHighLevel returns an error?

The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.

Does Create GoHighLevel Contact support batch operations?

Yes. Run Create GoHighLevel Contact inside a Loop node to process arrays. Tiny Command handles GoHighLevel's rate limits automatically so you don't have to throttle manually.

More actions