Skip to main content

Python SDK for accessing Freshsales

Project description


Unofficial Python SDK for accessing Freshsales.

Warning: This is undergoing active development and we will accept contributions once things are a little stable.


  1. Download this project and use it (copy it in your project, etc).
  2. Install it from pip.
pip install freshsalessdk


To use this SDK you'll need these Freshsales credentials and your Freshsales domain ( See official documentation for steps. We'll assume these are available via environment variables thusly:

export FS_API_KEY=xxx
export FS_DOMAIN=yyy

The following snippet shows you how to initialize and use the SDK.

from freshsalessdk import FreshsalesSDK
import os

fs = FreshsalesSDK(

# get contact views
views = fs.contacts.get_views()

# get contacts in a view
view_id = 123
contacts = fs.contacts.get_all(view_id=view_id)
contacts = list(fs.contacts.get_all_generator(view_id=view_id))

# get specific contact
contact_id = 1232
contact = fs.contacts.get(id=contact_id)

# get contact activities
activities = fs.contacts.get_activities(id=contact_id)

# get account views
views = fs.accounts.get_views()

# get accounts in a view
view_id = 123
accounts = fs.accounts.get_all(view_id=view_id)
accounts = list(fs.accounts.get_all_generator(view_id=view_id))

# get one account
account_id = 1221
account = fs.accounts.get(id=account_id)

# get deal views
views =

# get deals in a view
view_id = 1212
deals =
deals = list(

# get single deal
deal_id = 12121
deal =

Code-hygiene, Tests and Code Coverage

To ensure that coding styles are followed, run the following command:

pylint --rcfile=.pylintrc freshsalessdk test

To run integration tests, you'll need to set FS_DOMAIN and FS_API_KEY environment variables. In addition, you should have a view with all objects "All Contacts" for contacts and similarly "All Accounts" for accounts and "All Deals" for deals. Then simply run:

python -m pytest

To get code coverage, run the tests thusly.

python -m pytest --cov=freshsalessdk

Which produces output like this:

---------- coverage: platform darwin, python 3.7.4-final-0 -----------
Name                             Stmts   Miss  Cover
freshsalessdk/            3      0   100%
freshsalessdk/     130      6    95%
TOTAL                              133      6    95%

We want to maintain more than 90% code coverage. To get lots of debugging data during tests, edit the pytest.ini file.

To get code coverage report in HTML, run this command:

python -m pytest --cov=freshsalessdk --cov-report html:cov_html


This project is licensed under the MIT License - see the LICENSE file for details

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

freshsalessdk-0.1.3.tar.gz (6.0 kB view hashes)

Uploaded source

Built Distribution

freshsalessdk-0.1.3-py3-none-any.whl (8.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page