---
id: salesforce-cdp-connector
version: "1.0.20"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# salesforce-cdp-connector — Salesforce Data Cloud Python Connector

License: permissive · Maintenance: active · Downloads: 79.4K/mo

## 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 above — 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

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

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 79.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

salesforce data cloud connector, query salesforce cdp python, salesforce customer data platform api, load salesforce data to pandas, salesforce oauth authentication, cdp query execution python, salesforce datacloud client, salesforce-integration, data-cloud, deprecated

[View on SkillFed](https://skillfed.io/packages/salesforce-cdp-connector) · [View on PyPI](https://pypi.org/project/salesforce-cdp-connector/)