salesforce-cdp-connector

What it is and what it does

salesforce-cdp-connector is a read-only Python client for Salesforce Data Cloud (CDP) that lets you authenticate to Salesforce and execute queries against your CDP instance. It supports multiple authentication flows—JWT with private keys, username/password, OAuth tokens, and client credentials—and returns results either as raw cursor objects or directly as pandas dataframes. The package wraps the Salesforce CDP API behind a simple connection interface, handling authentication and query execution so you can focus on data retrieval and analysis.

However, this package is deprecated and will be removed once salesforce-datacloud-connector reaches general availability. The maintainers recommend migrating existing projects and using the newer package for all new work. While the current version remains active and receives commits, choosing this package means committing to a future migration path.

Use it for:

• Extract customer segments or profiles from Salesforce Data Cloud into a pandas dataframe for analysis or reporting.
• Build a scheduled ETL job that queries CDP data and loads results into a data warehouse or analytics platform.
• Authenticate to Salesforce CDP using client credentials in a server-to-server integration without user context.
• Execute ad-hoc CDP queries from a Python notebook or script using cursor-based result fetching.
• Query a non-default dataspace in your Salesforce CDP instance for multi-tenant or isolated data access.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Connects Python to Salesforce Data Cloud to execute queries and load results into pandas dataframes or cursor objects, supporting multiple authentication methods including JWT, OAuth, and client credentials.

No for new projects—the package is explicitly deprecated in favor of salesforce-datacloud-connector. Yes-with-conditions for existing codebases already using it: the package is actively maintained and has no known vulnerabilities, but plan a migration to the newer package. Do not start new projects with this connector.

Install

salesforce-cdp-connector on PyPI

pip install salesforce-cdp-connector

uv add salesforce-cdp-connector

poetry add salesforce-cdp-connector

Installing salesforce-cdp-connector

Before you install

Low install friction with standard dependencies. Active maintenance as of 2026-06-02 with recent commits; however, this package is explicitly deprecated in favor of salesforce-datacloud-connector, which is recommended for new projects.

License in practice

BSD-3-Clause is permissive and allows commercial use, modification, and distribution with minimal restrictions, making it suitable for most integration scenarios.

Quickstart

from salesforcecdpconnector.connection import SalesforceCDPConnection

conn = SalesforceCDPConnection(
    login_url='<url>',
    client_id='<id>',
    client_secret='<secret>'
)
cur = conn.cursor()
cur.execute('<query>')
results = cur.fetchall()

Requires a Salesforce connected app configured with Client Credentials flow enabled and appropriate OAuth scopes (refresh_token, api, cdp_query_api, cdp_profile_api).

Verify before relying

• Whether the package's deprecation timeline affects support or bug fixes going forward.
• Performance characteristics when handling large result sets or complex queries.
• Compatibility guarantees with Salesforce API versions and Data Cloud feature releases.

Package facts

Evidence: salesforce_cdp_connector-1.0.20-py3-none-any.whl

Keywords: cdp, dbapi, salesforce

Tags

More Front-Ends packages