---
id: simple-salesforce
version: "1.12.10"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# simple-salesforce — A basic Salesforce.com REST API client.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install simple-salesforce
uv add simple-salesforce
poetry add simple-salesforce

## Description

*****************
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...

## AI interpretation — verify before relying

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.

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+.

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