GOHIGHLEVEL ANSWERS & PROMPTS: PLAYBOOK T22 · WORKFLOWS & AUTOMATION
AUTHOR: DANIEL HALLMAN
KEYWORD: WORKFLOW
PLAYBOOK T22 · Workflows & Automation KEYWORD: WORKFLOW

Why is my GoHighLevel Inbound Webhook not creating or updating contacts?

Answer: Fetch a real sample request inside your Inbound Webhook trigger (never use the Test Workflow button), add a Format Data > Format Phone Number (E.164) step first, and map the formatted phone and email into Create/Update Contact.

STEP-BY-STEP INSTRUCTIONS + ANNOTATED GHL SCREENSHOTS

Steps in GoHighLevel

  1. STEP 1
    Lock a Real Webhook Sample: In Automation > Workflows > Inbound Webhook Trigger, click Fetch Sample Requests, send one live POST payload to the webhook URL, select that request in the dropdown, and click Save Trigger.
    REAL GHL SCREEN · AUTOMATION > WORKFLOW BUILDER CANVAS ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Workflow Builder canvas screenshot showing If/Else condition branch, priority routing steps, and Builder/Settings/Execution logs tabs
    1Add If/Else Condition & Tag Guard 2Chain Priority & Wait Steps 3Switch to Settings or Execution Logs
  2. STEP 2
    Format the Phone to E.164 First: In Automation > Workflows, add Format Data > Format Phone Number as your first action, select the phone field from Inbound Webhook Request, and set the format to E.164 (+1XXXXXXXXXX).
    REAL GHL SCREEN · AUTOMATION > WORKFLOWS ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Automation Workflows screenshot showing Automation sidebar item, + Create Workflow button, and Global Workflow Settings
    1Click Automation in Left Menu 2Click + Create Workflow or Build with AI 3Check Global Workflow Settings
  3. STEP 3
    Map Cleaned Tokens in Create/Update Contact: In Automation > Workflows, add Create/Update Contact right below Format Data, map Phone to {{format_data.phone}} and Email to {{inboundWebhookRequest.email}}, and click Publish.
    REAL GHL SCREEN · WORKFLOW > SETTINGS (RE-ENTRY & STOP ON RESPONSE) ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Workflow Settings screenshot showing Settings tab, Allow re-entry toggle, and Stop on response toggle
    1Open Workflow Settings Tab 2Toggle Allow Re-entry Rules 3Enable Stop on Response
MODE: AGENT PROMPT
PASTE INTO CLAUDE CODE, CURSOR, CHATGPT, OR GOHIGHLEVEL ASK AI AGENT PROMPT
Fix our GoHighLevel Inbound Webhook workflow that fails with "Contact could not be Created/Updated as no differentiation field value was provided (Email or Phone)":
1. Inspect the Inbound Webhook Trigger payload structure to verify the exact paths for phone and email (e.g. inboundWebhookRequest.phone vs inboundWebhookRequest.body.phone).
2. Insert a native "Format Data — Format Phone Number" action before "Create/Update Contact" to normalize the incoming phone string into E.164 (+1XXXXXXXXXX).
3. Map the formatted phone token and raw email token into the "Create/Update Contact" action and verify deduplication settings match Phone first, then Email.
Cause
  • When an external form or webhook sends JSON into a HighLevel Inbound Webhook Trigger, Create/Update Contact fails with 'Contact could not be Created/Updated as no differentiation field value was provided (Email or Phone)' if you clicked 'Test Workflow' (which sends blank tokens), passed an unformatted phone string
  • or mapped the wrong nested JSON key.
GoHighLevel Configuration
  • Lock a real live POST payload inside the Inbound Webhook Trigger settings so HighLevel registers the JSON schema, normalize the incoming phone string to E.164 (+1XXXXXXXXXX) before contact creation
  • and map the formatted output directly into Create/Update Contact.
MENU PATH REFERENCE

GoHighLevel Menu Paths

Step Menu Path in GHL Action
Step 1 Automation > Workflows > Inbound Webhook Trigger Click Fetch Sample Requests, send one live POST payload to the webhook URL, select that request in the dropdown, and click Save Trigger.
Step 2 Automation > Workflows Add Format Data > Format Phone Number as your first action, select the phone field from Inbound Webhook Request, and set the format to E.164 (+1XXXXXXXXXX).
Step 3 Automation > Workflows Add Create/Update Contact right below Format Data, map Phone to {{format_data.phone}} and Email to {{inboundWebhookRequest.email}}, and click Publish.
Fixing GoHighLevel Inbound Webhook Contact Could Not Be Created or Updated Email or Phone Error
VISUAL PLAYBOOK · PLAYBOOK T22 (WORKFLOWS & AUTOMATION) Back to Annotated GHL Screenshots ↑
DEFAULT SETUP VS. AUTOMATED WORKFLOW

Operational Comparison

Speed to Lead & Callback Safety
Default 0s Checkbox: Collides with Rep
45s Guard Workflow: Zero Collision
Caller Reply & Booking Rate
Generic 'We Missed You' SMS: 12%
Question-First Workflow SMS: 64%

Related Questions

BUILD FASTER IN GOHIGHLEVEL · FREE TRIAL BONUSES + MCP SERVER

Build this directly inside your GoHighLevel sub-account

Connect Claude Code, Cursor, or OpenAI Codex to our ghl-tools MCP Server & Rust CLI to build workflows, forms, and funnels from your editor, or start your GoHighLevel plan through our partner link to unlock $612+ in ready-to-import kits (including GHL Workflow Recipe Pack ($47 — or Free with Trial)) and weekly live clinics.