This guide connects one GoHighLevel Location (also called a sub-account) to one Armbrain client, prospect, or company mind. Armbrain then reads new and changed contacts about every 15 minutes.
Armbrain asks only for contacts.readonly, which means permission to read contacts. It cannot change your contacts, pipelines, automations, opportunities, conversations, or GoHighLevel settings.
Before you start
Have these ready:
- Your Armbrain login.
- A client, prospect, or company mind for the business you are connecting.
- A GoHighLevel login that is allowed to install Marketplace apps for that Location.
- The exact Location name, especially if your GoHighLevel login can access several sub-accounts.
You will not need to give Armbrain an API key, client secret, or password. Never paste GoHighLevel credentials into Armbrain, Claude, email, or support chat.
Choose the right Armbrain mind
One GoHighLevel Location connects to one Armbrain mind. Think of the mind as the private workspace for one business: every contact imported from that Location stays in that business's mind.
Do not connect GoHighLevel to your personal mind. A personal mind is for your own notes, not a client's CRM records. If you manage three client Locations, create three connections—one from each client's mind.
Install and connect
Step 1: Open Armbrain HQ
Action: Go to https://hq.armbrain.io.
What should happen: You should see Armbrain HQ or its sign-in page.
If it does not: Take a screenshot that includes the page and any error message, then email it to support@armbrain.io. Do not include passwords or security codes.
Step 2: Sign in to Armbrain
Action: Sign in with your Armbrain account.
What should happen: Your Armbrain HQ home screen should open.
If it does not: Take a screenshot of the error and email it to support@armbrain.io. Do not include your password or a sign-in code.
Step 3: Select the business mind
Action: Select the client, prospect, or company mind that belongs to the GoHighLevel Location you plan to connect.
What should happen: Armbrain HQ should show that business as the selected mind.
If it does not: Stop before connecting. Confirm that the mind exists and that you have access to it. If you still cannot select it, take a screenshot and email support@armbrain.io.
Step 4: Open Settings
Action: Open Settings in Armbrain HQ.
What should happen: The Settings area should open.
If it does not: Refresh https://hq.armbrain.io once. If Settings is still unavailable, take a screenshot and email support@armbrain.io.
Step 5: Open Connectors
Action: Open Connectors from Settings.
What should happen: You should see the connectors available for the selected mind.
If it does not: Take a screenshot of the Settings area and email support@armbrain.io.
Step 6: Start the GoHighLevel connection
Action: Find GoHighLevel CRM and choose Connect GoHighLevel.
What should happen: A secure GoHighLevel authorization page should open for the Marketplace app named Armbrain.
If it does not: Start again from Armbrain HQ; the secure link expires after five minutes. If GoHighLevel CRM is not listed or the page still will not open, take a screenshot and email support@armbrain.io.
Step 7: Sign in to GoHighLevel
Action: Sign in on the GoHighLevel page if GoHighLevel asks you to.
What should happen: You should reach the Armbrain authorization or installation screen in GoHighLevel.
If it does not: Ask your GoHighLevel account owner or agency administrator to confirm that your user can install Marketplace apps. Because GoHighLevel wording can vary by account, open the App Marketplace from your Sub-Account and look for Armbrain rather than relying on a particular menu label. If you remain stuck, take a screenshot and email support@armbrain.io.
Step 8: Choose one Location
Action: Choose the single GoHighLevel Location that belongs to the Armbrain mind you selected in Step 3.
What should happen: GoHighLevel should show that Location as the installation target.
If it does not: Stop and check that you are in the correct Sub-Account and have permission to install apps there. Do not choose a different Location just to continue. If the correct Location is unavailable, take a screenshot and email support@armbrain.io.
Step 9: Approve read-only contact access
Action: Approve the Armbrain connection only when the requested access is contacts.readonly.
What should happen: GoHighLevel should approve the connection and return you to Armbrain HQ.
If it does not: Do not approve broader access. Take a screenshot of the permissions or error, hide any personal contact details, and email it to support@armbrain.io.
Step 10: Confirm the connector started
Action: Look at GoHighLevel CRM in Armbrain HQ.
What should happen: Its status should be active. Armbrain will start importing contacts on its next scheduled check.
If it does not: Wait one minute and refresh once. If the connector stays pending or shows an authentication error, disconnect it and repeat Steps 6–9. If that fails, take a screenshot and email support@armbrain.io.
Check that contacts are going to the right place
Step 11: Wait for the first sync
Action: Allow at least 15 minutes for Armbrain's first contact check.
What should happen: The connector should begin importing contacts created or updated within the last 30 days. A large Location may need more than one 15-minute cycle.
If it does not: If no contacts appear after two cycles, take a screenshot of the connector status and email support@armbrain.io with the Location name and Armbrain mind name. Do not send credentials.
Step 12: Search for a known contact
Action: In the selected Armbrain mind, search for one contact created or updated in that GoHighLevel Location within the last 30 days.
What should happen: The contact should appear in the selected mind.
If it does not: Confirm the contact belongs to the connected Location and wait for the next sync. If it is still missing after two cycles, take a screenshot and email support@armbrain.io.
Step 13: Confirm the Location-to-mind mapping
Action: While the GoHighLevel CRM connector is visible, compare the selected Armbrain mind with the business whose Location you chose in Step 8.
What should happen: The selected mind should be the client, prospect, or company that owns that Location. The connector is pinned to this mind; it does not send contacts to other minds.
If it does not: Disconnect GoHighLevel from the incorrectly selected mind immediately. Take a screenshot that shows the selected mind and connector, then email support@armbrain.io. Do not reconnect until support confirms the correct next step.
Connect from Claude instead
You can start the same secure connection from Claude after switching to the destination client, prospect, or company mind.
Claude must already be connected to Armbrain before you use these steps.
Step 1: Switch to the destination mind
Action: Ask Claude to switch to the business mind that should receive the GoHighLevel contacts.
What should happen: Claude should confirm the selected client, prospect, or company mind.
If it does not: Do not continue. Ask Claude to list your minds, select the correct non-personal mind, and try again. If that fails, take a screenshot and email support@armbrain.io.
Step 2: Request the connection
Action: Ask Claude to run:
connectors action=connect source_type=gohighlevelWhat should happen: Claude should return a secure auth_url, meaning a browser link for GoHighLevel authorization.
If it does not: Start a new request once. If no secure link appears, take a screenshot and email support@armbrain.io.
Step 3: Open the secure link
Action: Open the returned auth_url within five minutes.
What should happen: The authorization flow should open; continue with main Steps 7–10, skipping sign-in if you are already signed in.
If it does not: Request a new link because expired links cannot be reused. If a fresh link fails, take a screenshot and email support@armbrain.io.
If you connected the wrong Location or mind
Disconnect GoHighLevel in Armbrain HQ, select the correct client, prospect, or company mind, and connect again. Disconnecting stops future syncs but preserves memories already imported. If contacts landed in the wrong mind, email support@armbrain.io before reconnecting so support can help you handle the existing records safely.