For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/features/integrations/import-from-gohighlevel.md.
  • English
  • How do I import contacts, companies and opportunities from GoHighLevel?

    You connect a GoHighLevel sub-account (location) with a private integration token, choose what to bring, and Clickmax copies the data. Clickmax only reads GoHighLevel: nothing changes there. The import does not trigger automations, broadcasts or webhooks, and you can repeat it later without duplicating records.

    Before you start

    • To import: workspace role Owner or Administrator, or a Member whose job title has the Importar de outro CRM (Import from another CRM) permission. To connect the account, the job title also needs access to Integrations. See roles and permissions.
    • In GoHighLevel: the token must come from a private integration created inside the sub-account. An agency token cannot read contacts or opportunities.
    • Each workspace connects one GoHighLevel sub-account. To bring another sub-account, connect it after the first import finishes.
    • Only one import can run at a time per workspace.

    Create the token and copy the location ID

    Do this in GoHighLevel, in another tab, inside the sub-account.

    1. Open Settings > Private Integrations and click Create new integration.
    2. Give it a name and select these read scopes:
      • contacts.readonly, opportunities.readonly, users.readonly and locations.readonly are required.
      • locations/customFields.readonly brings custom fields, locations/tasks.readonly brings tasks and businesses.readonly brings companies.
    3. Create the integration and copy the token. GoHighLevel shows the token only once.
    4. Copy the location ID under Settings > Business Profile.

    If an optional scope is missing, the connection still works and that data is left out. The integration screen shows what was left out.

    Connect in Clickmax

    1. Open Integrações (Integrations) > Explorar integrações (Explore integrations) and select the GoHighLevel · import data card.
    2. Under Connect your account, paste the token into Private integration token and the ID into Location ID (sub-account). Use Show token to check what you pasted.
    3. Click Connect account.

    Once connected, the screen shows the Connected badge and the sub-account name and ID. To change the token, paste the new token and the location ID and click Update connection. Disconnect removes the connection; what was already imported stays in Clickmax.

    Choose what to bring

    Click Import data from GoHighLevel. You can also get here from the contacts list: in the arrow next to Add contact, choose Import contacts and, below the file area, click GoHighLevel (on a phone, tap +N more first if it is not shown). If the account is already connected, the chip shows Connected and the import opens right there, without leaving Contacts. The window has three steps: Map, Review and Import.

    In the Map step:

    1. Owners: choose the Clickmax attendant for each GoHighLevel user. Users without a match come in with no owner, or with the Default owner if you pick one. The import does not create attendants or send invitations.
    2. Pipelines: each GoHighLevel pipeline can become a new pipeline with the same stages (Create a new pipeline) or be left out (Do not import). Clickmax adds two stages at the end of each pipeline, Ganho (Won) and Perdido (Lost), for won, lost and abandoned opportunities.
    3. Fields, in the Contacts, Companies and Deals tabs:
      • For contacts and opportunities, each GoHighLevel field can become a new field (Create field "…"), go to a Field that already exists in Clickmax, or be left out (Do not import). For opportunities, only custom fields are listed: name, value, stage, owner and status always come over.
      • For companies, the field goes to a Clickmax field or is left out.
    4. What to bring: select Notes and Tasks. Lists, Calls, meetings and emails and Files are disabled, with the notice GoHighLevel does not provide this data through its API.
    5. When the contact already exists in Clickmax:
      • Fill only what is empty (default).
      • Replace with the GoHighLevel data.
      • Leave the contact as it is.

    Clickmax spots repeated contacts by e-mail, phone or CPF, with the same rules as the spreadsheet import.

    Click Continue. In the Review step, check the GoHighLevel totals and how many contacts, fields and pipelines are new. Then click Import.

    Notes in large accounts

    GoHighLevel only returns notes one contact at a time: the import makes one call per contact to read the notes. In a sub-account with many contacts, this takes longer and uses a large part of the sub-account's daily call limit. If you do not need the notes, clear Notes.

    What comes over and how it looks in Clickmax

    In GoHighLevelIn Clickmax
    ContactContact
    BusinessCompany, linked to its contacts
    OpportunityOpportunity, in the same stage. Won opportunities sit in the Ganho (Won) stage; lost and abandoned ones in Perdido (Lost), with the date of the last status change. Lost opportunities keep their lost reason; abandoned ones without a reason get the reason Abandonado (Abandoned).
    Pipeline and stagesPipeline with the same stages, plus Ganho and Perdido
    UserOwner, as set in the Owners step
    Contact tagTag GoHighLevel: <tag>
    Contact noteContact timeline, marked Imported from GoHighLevel
    TaskTask, with the due date. Completed tasks come in as completed.

    What does not come over

    • Smart lists: GoHighLevel does not provide them through its API.
    • Conversations and messages (SMS, WhatsApp, e-mail) and calls.
    • Files, including the ones in upload fields.
    • GoHighLevel funnels, automations, calendars and appointments.
    • Fields that point to another record.

    Follow, stop and repeat

    You can close the window: the import keeps running, and when you come back you see the progress per type (Read, Created, Already existed, Skipped, Failed).

    StatusWhat it means
    Reading your GoHighLevel data...Clickmax is reading GoHighLevel.
    Ready to importReading is done.
    Importing into Clickmax...The data is coming in.
    GoHighLevel limited the calls. The import resumes at …Nothing to do. The import resumes on its own at the time shown.
    The GoHighLevel key stopped working…Click Reconnect GoHighLevel, paste a valid token and the location ID and click Continue import. It continues from where it stopped.
    Import complete.Done.
    The import failed.See Common errors.
    Import stopped.You stopped the import.

    GoHighLevel limits how many calls each sub-account makes per day, and that limit is shared by all integrations of the sub-account. The import leaves part of the limit free so your other integrations keep working. When the limit runs out, the import pauses and resumes on its own when GoHighLevel allows calls again.

    • Stop: click Stop import. What already came in stays in Clickmax.
    • Items that did not come in: click Download items not imported. The spreadsheet importacao-gohighlevel-pendencias.csv lists the type and the reason of each item, with the status falhou (failed), ignorado (skipped) or aviso (warning). aviso means the item came in, but an association (for example, a contact's company) was left out.
    • Repeat: importing again does not duplicate anything. Contacts and companies are updated according to the option you pick under When the contact already exists in Clickmax. Opportunities and history that already came in are not rewritten.

    Common errors

    Clickmax shows these messages in Portuguese. The English below is a translation.

    MessageWhat to do
    GoHighLevel refused the token. Check that you copied the whole token and that it comes from a private integration of the sub-account.Copy the token again. Check that the private integration was created inside the sub-account, not in the agency.
    GoHighLevel did not find this location. Check the sub-account ID.Copy the ID again under the sub-account's Settings > Business Profile.
    The GoHighLevel token is missing permissions: …Create a new private integration with the required scopes and paste the new token.
    GoHighLevel reached this sub-account's daily call limit. Try again tomorrow.Wait until the next day and try again.
    GoHighLevel is limiting this sub-account's calls. Try again in 1 minute.Wait a minute and try again.
    The GoHighLevel key was revoked or expired. Reconnect under Integrations.Paste a valid token and the location ID under Update connection. If an import was running, click Continue import.
    An import is already running. Wait or cancel it first.Follow the current import or click Stop import.
    Could not reach GoHighLevel right now. Try again in a few minutes.GoHighLevel is unavailable. Try again later.