simple-salesforce

A basic Salesforce.com REST API client.

simple-salesforce Permissive license Apache-2.0 Active ★ 1,889 v1.12.10 released 2026-07-08

Install

simple-salesforce on PyPI

pip

pip install simple-salesforce

uv

uv add simple-salesforce

poetry

poetry add simple-salesforce

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.9)
Install friction	low — pure-Python wheel
Runtime dependencies	5 — requests, typing-extensions, zeep, pyjwt, more-itertools
Maintenance	actively maintained — 36 days since the last release
Last repo commit	2026-07-08
First released	2013-01-22
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: simple_salesforce-1.12.10-py3-none-any.whl

Keywords: python, salesforce, salesforce.com, CRM, API, REST

Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: System AdministratorsOperating System :: OS IndependentProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: PyPyTopic :: Internet :: WWW/HTTP

About simple-salesforce

from the package's own PyPI description — quoted content, verbatim

Simple Salesforce

.. image:: https://github.com/simple-salesforce/simple-salesforce/actions/workflows/test.yml/badge.svg :target: https://github.com/simple-salesforce/simple-salesforce/actions

.. image:: https://readthedocs.org/projects/simple-salesforce/badge/?version=latest :target: http://simple-salesforce.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status

Simple Salesforce is a basic Salesforce.com REST API client built for Python 3.9, 3.10, 3.11, 3.12, and 3.13. The goal is to provide a very low-level interface to the REST Resource and APEX API, returning a dictionary of the API JSON response. You can find out more regarding the format of the results in the Official Salesforce.com REST API Documentation_

.. _Official Salesforce.com REST API Documentation: http://www.salesforce.com/us/developer/docs/api_rest/index.htm

Documentation

.. _Official Simple Salesforce documentation: http://simple-salesforce.readthedocs.io/en/latest/

Official Simple Salesforce documentation_

Examples

There are two ways to gain access to Salesforce

The first is to simply pass the domain of your...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Simple Salesforce is a lightweight REST API client for Salesforce.com that returns API responses as Python dictionaries, supporting multiple authentication methods and SOQL/SOSL queries for record management and retrieval.

Low install friction with a pure-Python wheel distribution. The package is actively maintained (last commit 2026-07-08, 36 days since release) and supports Python 3.9–3.14 including PyPy. Five runtime dependencies (requests, typing-extensions, zeep, pyjwt, more-itertools) are all well-established libraries.

Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions—suitable for most organizational and proprietary projects.

Usage

pip install simple-salesforce

from simple_salesforce import Salesforce
sf = Salesforce(username='user@example.com', password='password', security_token='token')
contact = sf.Contact.get('003e0000003GuNXAA0')

Requires Python 3.9 or later; Salesforce credentials (username, password, and security token or equivalent authentication method) must be provided.

Verdict: Simple Salesforce is a stable, actively maintained production-grade client for Salesforce REST API integration. With Apache-2.0 licensing, low install friction, no known vulnerabilities, and broad Python version support, it is well-suited for building Salesforce integrations in Python 3.9+.

Needs verification

Whether zeep (SOAP library) is used for SOAP API support or only as a transitive dependency.
Performance characteristics and rate-limiting behavior when handling large record batches or complex SOQL queries.

salesforce rest api clientsalesforce crm pythonsalesforce authenticationsoql query buildersalesforce record managementsalesforce.com integrationpython salesforce connector