Pipedrive Access (BYOK) — connector documentation
- MCP endpoint:
https://byok-pipedrive-access.connectorbay.com/mcp - REST API:
POST https://byok-pipedrive-access.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec athttps://byok-pipedrive-access.connectorbay.com/openapi.json - Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
- Authentication: your own Pipedrive Access personal API token (an admin user's token for roles and permission sets), sent in the
X-Upstream-Keyheader of every request (never stored, logged or cached) - Health:
https://byok-pipedrive-access.connectorbay.com/health· Tool schemas:https://byok-pipedrive-access.connectorbay.com/tools.json - Publisher: Unify Dynamics LLC · connectorbay.com/byok-pipedrive-access · agent@connectorbay.com
What Pipedrive Access (BYOK) is for
Pipedrive Access (BYOK) lets an AI assistant read your own Pipedrive Access data through the Pipedrive Access API with a key you supply (personal API token (an admin user's token for roles and permission sets)). Read-only: 8 tools (list_roles, get_role, get_role_pipeline_visibility, list_permission_sets, get_permission_set, list_teams, get_team, list_users). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.pipedrive.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Pipedrive Access. Pipedrive Access and its logos are trademarks of their owners and are used only to say which service the connector works with.
Ask your assistant things like:
- "Which roles exist in our Pipedrive account?"
- "What can the Pipedrive role 1 see by default?"
- "Which Pipedrive pipelines can role 1 see?"
- "What permission sets does Pipedrive have for the sales app?"
- "What does the Pipedrive permission set e3a5 allow?"
- "Which teams are set up in Pipedrive?"
What it does
list_roles: List the account's roles with name, parent role, level, active flag and how many users hold each. Needs the visibility and sharing settings feature.get_role: Get one role with its parent, level, assignment counts and default visibility and access level settings per record type.get_role_pipeline_visibility: List the pipeline ids that are visible (or hidden) to a role.list_permission_sets: List permission sets with name, description, app, type (admin, manager, regular, custom) and how many users have each.get_permission_set: Get one permission set by id with its description, app, type, assignment count and the permissions it grants.list_teams: List teams (legacy teams) with name, description, manager and member user ids.get_team: Get one team by id with name, description, manager and member user ids.list_users: List the account's users with name, role id, active flag, time zone and app access. Email addresses, phone numbers and logins are not returned.
BYOK key
You bring your own Pipedrive Access personal API token (an admin user's token for roles and permission sets) (https://support.pipedrive.com/en/article/how-can-i-find-my-personal-api-key). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.pipedrive.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.
Data sources
- https://developers.pipedrive.com/docs/api/v1 (the API this connector calls, with a BYOK key)
Live from the Pipedrive Access API (api.pipedrive.com) with a BYOK key; documentation: https://developers.pipedrive.com/docs/api/v1. Endpoints checked against that documentation on 2026-10-16.
What it is not
Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Pipedrive Access. Pipedrive Access and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Pipedrive Access account.
Built for: Worldwide. Languages: English.