Before you start
Access to Morada OS
An active account on os.morada.ai, with your company’s corporate login.
Your Pipedrive token is yours, and tied to your company
Pipedrive issues an API token to each person, inside the company account. You copy it from Pipedrive itself, and it gives the assistant exactly what your own account can see there: never more, never less.
Do you belong to more than one company on Pipedrive? The token is per company: each one has its own. If you connect the wrong company’s token, the assistant queries the wrong base without warning. To check, ask in chat “who is connected on Pipedrive?”: the answer always says which company the token opened.
How to connect
1
Copy your API token from Pipedrive
In Pipedrive, click the account name (top right), open Company settings > Personal preferences > API (or go to app.pipedrive.com/settings/api) and copy the displayed token.If the API option does not appear for you, whoever administers your company’s Pipedrive needs to enable the “use API” permission on your profile (Manage users > Permission sets).Careful: Pipedrive shows one single active token per person. Generating a new one stops the old one immediately, including for other integrations already using it.
2
Open the connectors
In the Morada OS sidebar, click Conectores (Connectors). The page shows the available accounts and systems.
3
Pick Pipedrive
Find the Pipedrive card and click Conectar (Connect). If the shelf is full, use the search at the top.
4
Paste the token
A short form appears on the card itself, with a single box:
- Token de API (API token): paste the value copied from Pipedrive.
The token is stored encrypted and Morada OS never shows it back, not even to you. The screen only shows that a connection exists and when it was made.
What the assistant can do
In this version the connector is read-only: the assistant reads Pipedrive and never writes anything to it.Adjust the permissions on your card
Open Conectores > Pipedrive and you see the list O que Morada OS pode ler (what Morada OS can read), with a label on each tool:- Sempre permitir (always allow): the tool runs directly when your request needs it. This is the default, because none of them changes Pipedrive.
- Perguntar antes (ask first): the assistant asks for your confirmation in chat before querying.
Everyday use
How to disconnect
Open Conectores > Pipedrive and use Desvincular (Unlink) on the card. The assistant stops accessing your Pipedrive immediately. Disconnecting in Morada OS does not revoke the token on Pipedrive: while it remains valid there, whoever holds it can use it. To truly revoke it, generate a new token at app.pipedrive.com/settings/api: the old one stops working everywhere, including in other integrations using it.Next steps
All integrations
Everything else Morada OS connects to and where to find each guide.
How to ask well
Three minutes that improve every request you make to the assistant.