GActionGoHighLevelUpdated June 2026

How do I add a contact to GoHighLevel?

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

Inputs

The fields this action accepts.

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

FieldTypeRequiredDescription
Location ID
locationId
stringRequiredThe GoHighLevel sub-account (location) the contact belongs to.
Email
email
stringOptionalEmail. e.g. "user@example.com"
Phone
phone
stringOptionalPhone in E.164 format. e.g. "+15551234567"
First Name
firstName
stringOptionalFirst Name. e.g. "Jane"
Last Name
lastName
stringOptionalLast Name. e.g. "Smith"
Company
companyName
stringOptionalCompany Name. e.g. "Acme Inc"
Source
source
stringOptionalWhere this contact came from (used in GoHighLevel reporting). e.g. "Website Form"
Tags
tags
stringOptionalComma-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.

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

Other GoHighLevel actions.

Action
Add GoHighLevel Note
Attaches a note to a contact's timeline. Useful for "call summary → log to contact" or "support ticket resolution → add to client history" workflows.
Action
Create GoHighLevel Opportunity
Creates an opportunity with value, stage, owner, contact link. For "qualified lead → auto-create opportunity in the right pipeline" workflows.
Action
Get GoHighLevel Contact
Returns a contact by ID with all standard and custom fields plus tags, opportunities, and recent activities. The standard lookup before update or for context-enrichment workflows.
Action
Search GoHighLevel Contacts
Lookup by email, phone, name, or tag. The standard "find before update" dedupe pattern for upsert workflows.
Action
Send GoHighLevel Email
Sends a one-shot email to a contact via the GHL email system. Useful for transactional sends triggered by external events that should appear in the GHL contact timeline.
Action
Send GoHighLevel SMS
Sends SMS via the GHL number tied to the contact's sub-account. For "reminder SMS for appointments" or "promo SMS for the campaign" workflows where the message appears in the GHL conversation thread.

Send create gohighlevel contact from your workflows.

Triggered by anything in the catalog. Free tier available. No credit card.