GoHighLevel OAuth2
OAuth2 connection for GoHighLevel CRM.
Fields
| Field | Description | Required |
|---|---|---|
| Client ID | OAuth2 Client ID from your HighLevel marketplace app | Yes |
| Client Secret | OAuth2 Client Secret from your HighLevel marketplace app | Yes |
| User Type | Location (single sub-account) or Company (agency-level) | No |
| Scopes | OAuth scopes (defaults: contacts, opportunities, locations, users) | No |
| Default Location ID | Fallback location ID for node execution | No |
Setup Steps
- Step 1: Create a HighLevel Marketplace app (or use an existing one) and copy the Client ID and Client Secret
- Step 2: In Falcon Builder, go to Dashboard → Credentials → Add Credential
- Step 3: Select GoHighLevel OAuth2 as the credential type
- Step 4: Enter your Client ID and Client Secret
- Step 5: Select your User Type:
- Location (default) — connects to a single sub-account/location. Most common for standard use.
- Company — connects at the agency level with access to multiple locations. Requires a Location ID on each request.
- Step 6: Optionally set a Default Location ID — this will be used automatically in your workflow nodes
- Step 7: Click Connect HighLevel OAuth2 — a popup will open for you to authorize access in HighLevel
Token Management
After authorization, your access and refresh tokens are encrypted and stored securely. Tokens refresh automatically when they expire (HighLevel tokens last ~24 hours). If a refresh fails, you will need to reconnect via the OAuth flow.
Scopes
Default scopes requested during authorization:
contacts.readonly/contacts.writeopportunities.readonly/opportunities.writelocations.readonlyusers.readonly
You can customize scopes in the credential form if your HighLevel app requires different permissions.
Testing the Connection
After connecting, click Test Credential to verify your token works. The test makes a read-only API call to confirm access. If the test fails with a 401 or 403 error, try reconnecting with the OAuth flow.