Integration Docs
Connect Backbeam Studio with your GoHighLevel account to sync contacts, run campaigns against your CRM data, and keep both platforms in perfect alignment.
The Backbeam Studio × GoHighLevel integration creates a two-way sync between your CRM contacts and your Backbeam workspace. Once connected, you can pull your entire GHL contact database into Backbeam Studio to power campaigns, and push enriched or updated contacts back to GHL — all without manual CSV exports.
The connection is secured using OAuth 2.0, meaning Backbeam Studio never stores your GHL password. You grant access once, and our platform handles all API communication server-side on your behalf.
Before connecting, make sure you have the following ready:
Connecting takes under two minutes. Follow these steps exactly:
Open Settings
Log in to Backbeam Studio, navigate to your workspace, and click Settings in the left sidebar.
Go to Integrations
Select the Integrations tab. Locate the GoHighLevel card.
Click "Connect GoHighLevel"
You will be redirected to the GoHighLevel authorization page. This is GHL's official login portal — Backbeam Studio never sees your password.
Log In & Authorize
Sign in to your GHL account if prompted. Review the permissions being requested, then click Allow Access.
Redirect & Confirmation
You will be automatically returned to Backbeam Studio. A green "Connected" badge will appear on the GHL card, confirming the link is live.
ℹ️ Note: Access tokens are stored encrypted per workspace. If you have multiple workspaces, you will need to connect GHL separately for each one.
Pull your entire GoHighLevel contact list directly into your Backbeam Studio workspace:
Navigate to the Contacts page in your Backbeam Studio workspace.
Click the Import from GHL button in the top-right toolbar.
Backbeam Studio will fetch your contacts from the GHL API. For large contact lists, this process is paginated and may take a few seconds.
Once complete, a summary banner will display: "X contacts imported successfully."
Your contacts are now available in the workspace and can be added to new or existing campaigns.
⚠️ Duplicate Handling: If a contact already exists in your workspace (matched by email address), it will be updated with the latest data from GHL rather than duplicated.
Push contacts from Backbeam Studio back to your GoHighLevel CRM:
Navigate to the Contacts page and select the contacts you want to export. Use the checkbox to select individual contacts, or select all.
Click Export to GHL from the action bar that appears.
Backbeam Studio processes each contact. New contacts are created via POST /contacts/, and existing contacts (matched by email) are updated via PUT /contacts/{"{id}"}.
A confirmation summary will display: "X contacts exported, Y updated."
The following contact fields are synced in both directions between Backbeam Studio and GHL:
| Field | GHL Field Name | Direction |
|---|---|---|
| First Name | firstName | ⇄ Both |
| Last Name | lastName | ⇄ Both |
| Email Address | email | ⇄ Both |
| Phone Number | phone | ⇄ Both |
| Tags | tags | ⇄ Both |
| Created Date | dateAdded | → Import only |
Custom GHL fields are not currently synced. Contact support if you need custom field mapping.
When you authorise the connection, Backbeam Studio requests the following OAuth scopes from GoHighLevel:
contacts.readonlyAllows Backbeam Studio to read your contact list from GHL. Required for the Import feature.
contacts.writeAllows Backbeam Studio to create and update contacts in GHL. Required for the Export feature.
We request only the minimum permissions necessary to operate this integration. Backbeam Studio does not access your GHL workflows, pipelines, opportunities, or billing data.
You can revoke the integration at any time from either platform:
⚠️ Important: Disconnecting will immediately stop all syncing. Contacts already imported into Backbeam Studio will remain in your workspace — disconnecting does not delete any data.
Will importing contacts from GHL delete my existing Backbeam contacts?
No. Importing from GHL adds and updates contacts — it does not delete any existing records. Contacts are matched by email address. If a match is found, the contact is updated with fresh GHL data. If no match is found, a new contact is created.
How often does the sync happen? Is it automatic?
The current integration is on-demand. You initiate an import or export manually from the Contacts page. Automatic scheduled syncing is on our roadmap. If you need this feature urgently, please contact our support team.
I connected GHL but the "Import from GHL" button is greyed out. What do I do?
This typically means the OAuth token has expired or the connection was interrupted. Go to Settings → Integrations, disconnect GHL, and reconnect using the OAuth flow again. If the issue persists, contact support.
Does this integration support GHL sub-accounts or agency-level access?
The integration connects at the sub-account level. When you authorise via OAuth, you are granting access to the specific GHL location (sub-account) you are logged into. If you manage multiple GHL sub-accounts, you will need to create a separate Backbeam workspace for each and connect them individually.
Is my GHL data secure on Backbeam Studio?
Yes. OAuth tokens are encrypted at rest and stored per workspace in our secure database. We do not store your GHL credentials. All API calls are made server-side. You can revoke access from GHL at any time, which will immediately invalidate the tokens on our end.
Our team is here to help you get the most out of the GHL integration. If you run into any issues not covered in this documentation, reach out through any of the channels below: