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-pipedrive.md.
  • English
  • How do I import contacts, companies and opportunities from Pipedrive?

    You connect Pipedrive with your personal API token, choose what to bring, and Clickmax copies the data. Clickmax only reads Pipedrive: 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 Pipedrive: the token gives access to the same data your user sees. Use the token of a user who sees everything you want to bring, such as an account admin.
    • Each workspace connects one Pipedrive account.
    • Only one import can run at a time per workspace.

    Get the API token in Pipedrive

    Do this in Pipedrive, in another tab.

    1. Click your photo in the top right corner and open Personal preferences.
    2. Open the API tab.
    3. Copy the value of Your personal API token.

    Pipedrive has no per-token permissions: Clickmax reads everything your user sees.

    Connect in Clickmax

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

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

    Choose what to bring

    Click Import data from Pipedrive. 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 Pipedrive (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 Pipedrive 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 Pipedrive 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 and lost opportunities.
    3. Fields, in the Contacts, Companies and Deals tabs:
      • For contacts and opportunities, each Pipedrive 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: title, value, stage, owner and close date always come over.
      • For companies, the field goes to a Clickmax field or is left out. Custom organization fields are kept by the import (Keep in the company history), but they are not visible in Clickmax yet.
    4. What to bring: select Lists, Notes, Tasks, Calls, meetings and emails and Files. For Pipedrive, Files brings the files of deals and persons.
    5. When the contact already exists in Clickmax:
      • Fill only what is empty (default).
      • Replace with the Pipedrive 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 Pipedrive totals and how many contacts, fields and pipelines are new. Then click Import.

    What comes over and how it looks in Clickmax

    In PipedriveIn Clickmax
    PersonContact
    OrganizationCompany
    Deal, including archived onesOpportunity, in the same stage. Won and lost deals sit in the Ganho (Won) and Perdido (Lost) stages, with the date they were won or lost. Lost deals keep their lost reason.
    Pipeline and stagesPipeline with the same stages, plus Ganho and Perdido
    UserOwner, as set in the Owners step
    Person labelTag Pipedrive: <label>
    People filterList with the persons the filter shows today, named with (cópia do Pipedrive) (Pipedrive copy) at the end. It does not keep updating.
    NoteTimeline of the contact or opportunity, marked Imported from Pipedrive
    Done call, meeting, lunch or email activityTimeline, as a call, meeting or e-mail
    Other activities (deadlines, tasks and activities not done yet)Task, with the due date
    Deal file up to 25 MBAttachment on the opportunity
    Person file up to 25 MBEntry in the contact timeline, with the link to the file

    What does not come over

    • Deal products.
    • Leads in Pipedrive's Leads inbox.
    • Fields that point to another record, such as user, person, organization or deal fields.
    • The rules of filters.
    • Files that are only on an organization, Google Drive links and files over 25 MB.
    • Pipedrive automations, sequences, e-mail templates, web forms, projects and campaigns.
    • Custom organization fields: the import keeps them, but they are not visible in Clickmax yet.

    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 Pipedrive data...Clickmax is reading Pipedrive.
    Ready to importReading is done.
    Importing into Clickmax...The data is coming in.
    Pipedrive limited the calls. The import resumes at …Nothing to do. The import resumes on its own at the time shown.
    The Pipedrive key stopped working…Click Reconnect Pipedrive, paste a valid token 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.

    Pipedrive limits how many calls each account makes per day. The import uses that limit together with your other Pipedrive integrations. When it runs out, the import pauses and resumes on its own when Pipedrive 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-pipedrive-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
    Pipedrive refused the token. Check that you copied the whole token and that it is still active.Copy the token again under Personal preferences > API and paste it.
    Pipedrive reached this account's daily call limit. Try again tomorrow.Wait until the next day and try again.
    Pipedrive is limiting this account's calls. Try again in 1 minute.Wait a minute and try again.
    The Pipedrive key was revoked or expired. Reconnect under Integrations.Paste a valid token under Update token. 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 Pipedrive right now. Try again in a few minutes.Pipedrive is unavailable. Try again later.