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.
- Open Settings > Private Integrations and click Create new integration.
- Give it a name and select these read scopes:
contacts.readonly,opportunities.readonly,users.readonlyandlocations.readonlyare required.locations/customFields.readonlybrings custom fields,locations/tasks.readonlybrings tasks andbusinesses.readonlybrings companies.
- Create the integration and copy the token. GoHighLevel shows the token only once.
- 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
- Open Integrações (Integrations) > Explorar integrações (Explore integrations) and select the GoHighLevel · import data card.
- 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.
- 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:
- 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.
- 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.
- 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.
- 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.
- 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
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).
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.csvlists 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.