GOHIGHLEVEL ANSWERS & PROMPTS: PLAYBOOK T42 · SAAS SUB-ACCOUNT WEBHOOK PROVISIONING
AUTHOR: DANIEL HALLMAN
KEYWORD: CREATE SUBACCOUNT
PLAYBOOK T42 · SaaS Sub-Account Webhook Provisioning KEYWORD: CREATE SUBACCOUNT

How Do You Automate GoHighLevel Sub-Account Creation From Zapier or External Payment Webhooks (And Fix 403 Forbidden Errors)?

Answer: When Zapier or a webhook returns a 403 Forbidden resource error while creating a GoHighLevel sub-account, the connection is using a sub-account Location token instead of an Agency-level Private Integration token with the locations.write scope. On the $497/month Agency Pro plan, create an Agency-level Private Integration token in Agency View > Settings > Private Integrations, copy your target Snapshot ID, and fire POST https://services.leadconnectorhq.com/locations/ from a Custom Webhook action inside your Agency sub-account workflow whenever Whop, ThriveCart, or Stripe sends a payment webhook.

STEP-BY-STEP INSTRUCTIONS + ANNOTATED GHL SCREENSHOTS

Steps in GoHighLevel

  1. STEP 1
    In Agency View > Settings > Private Integrations, click Create New Integration, enable the locations.write and users.write scopes, and copy the Agency token (a sub-account token cannot create locations and causes the 403 Forbidden resource error).
    REAL GHL SCREEN · SETTINGS > PRIVATE INTEGRATIONS (API V2) ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Private Integrations API v2.0 screenshot showing Settings > Private Integrations menu, Create New Integration button, and scoped token audit row
    1Open Settings > Private Integrations 2Click Create New Integration 3Review Scoped Token & Last Used Date
  2. STEP 2
    In Agency View > Account Snapshots, locate the template snapshot you want loaded into each new customer account and copy its snapshotId from the snapshot settings menu.
    REAL GHL SCREEN · AGENCY VIEW > ACCOUNT SNAPSHOTS ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Agency Account Snapshots screenshot showing Account Snapshots menu, My/Imported/Shared snapshots tabs, and + Create snapshot button
    1Open Account Snapshots in Agency View 2Browse My, Imported & Shared Snapshots 3Click + Create Snapshot or Refresh Account
  3. STEP 3
    In Automation > Workflow Builder inside your main agency sub-account, trigger on Inbound Webhook from your payment processor, run Create/Update Contact, and add a Custom Webhook (POST https://services.leadconnectorhq.com/locations/) with headers Authorization: Bearer <AGENCY_TOKEN> and Version: 2021-07-28 passing companyId, name, email, phone, and snapshotId.
    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
MODE: AGENT PROMPT
PASTE INTO CLAUDE CODE, CURSOR, CHATGPT, OR GOHIGHLEVEL ASK AI AGENT PROMPT
Automate sub-account creation from an external payment webhook in agency sub-account <YOUR_LOCATION_ID>:
1. In Agency View > Settings > Private Integrations, create an Agency-scoped token with locations.write and users.write enabled.
2. In Agency View > Account Snapshots, copy the target snapshotId for new client onboarding.
3. In Automation > Workflow Builder, trigger on Inbound Webhook from the checkout processor, create the contact, and send a POST Custom Webhook to https://services.leadconnectorhq.com/locations/ with Version 2021-07-28 and snapshotId.
Cause
  • Operators selling GoHighLevel SaaS plans through external checkouts like Whop, Paddle, or ThriveCart often send the payment webhook into their main agency location to create a contact, then hit a wall trying to spin up the customer's sub-account.
  • Connecting Zapier with a location-level API key fails with a 403 Forbidden resource error because only Agency-scoped tokens have permission to provision new locations.
GoHighLevel Configuration
  • Generate an Agency-level Private Integration token with locations.write and users.write scopes in Agency View > Settings > Private Integrations, grab your vertical Snapshot ID in Agency View > Account Snapshots
  • and call the HighLevel v2 Locations endpoint directly from a Custom Webhook step inside your Agency sub-account's Inbound Webhook workflow.
MENU PATH REFERENCE

GoHighLevel Menu Paths

Step Menu Path in GHL Action
Step 1 Agency View > Settings > Private Integrations Click Create New Integration, enable the locations.write and users.write scopes, and copy the Agency token (a sub-account token cannot create locations and causes the 403 Forbidden resource error).
Step 2 Agency View > Account Snapshots Locate the template snapshot you want loaded into each new customer account and copy its snapshotId from the snapshot settings menu.
Step 3 Automation > Workflow Builder Trigger on Inbound Webhook from your payment processor, run Create/Update Contact, and add a Custom Webhook (POST https://services.leadconnectorhq.com/locations/) with headers Authorization: Bearer <AGENCY_TOKEN> and Version: 2021-07-28 passing companyId, name, email, phone, and snapshotId.
3-step diagram showing Agency token with locations.write enabled in Agency View, Payment webhook mapping buyer name, email, and phone, and Load snapshot creating a location with your snapshot ID.
VISUAL PLAYBOOK · PLAYBOOK T42 (SAAS SUB-ACCOUNT WEBHOOK PROVISIONING) Back to Annotated GHL Screenshots ↑
DEFAULT SETUP VS. AUTOMATED WORKFLOW

Operational Comparison

Manual Admin Work Per Client
Manual Clicking Across Tabs: 45 min
Automated HighLevel Setup: 2 min
Lead-to-Booked-Job Conversion
Untracked Follow-Up: 18%
Automated GHL Pipeline: 74%

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 SaaS Sub-Account Provisioning Pack) and weekly live clinics.