Salesforce-FuelSDK

What it is and what it does

Salesforce-FuelSDK is a Python client library for Salesforce Marketing Cloud's Fuel API family, providing access to both REST and SOAP endpoints. It abstracts the underlying HTTP and SOAP complexity into Python objects prefixed with "ET_" (e.g., ET_List, ET_Client), allowing developers to interact with marketing cloud resources like lists, campaigns, and contacts through a unified interface. The SDK supports OAuth2 authentication with refresh tokens and web/public app flows as of version 1.3.0.

The package depends on pyjwt for token handling, requests for HTTP communication, and suds-jurko for SOAP operations. However, the project has been archived and unmaintained since June 2023, with the last release in August 2019. This means no bug fixes, security patches, or compatibility updates are being applied, making it a legacy tool suitable only for maintaining existing integrations rather than starting new ones.

Use it for:

• Retrieve and manage subscriber lists from Salesforce Marketing Cloud within a Python application.
• Automate campaign creation and deployment against Marketing Cloud accounts programmatically.
• Sync contact data bidirectionally between an internal system and Salesforce Marketing Cloud.
• Query Marketing Cloud analytics and reporting data via the REST API.
• Maintain legacy integrations built on this SDK that cannot be easily migrated to newer tools.

Worth the install?

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

Provides Python bindings to Salesforce Marketing Cloud's REST and SOAP APIs, enabling programmatic access to marketing cloud services through a unified SDK interface.

No, unless you are maintaining an existing integration already built on this SDK. The project is archived and abandoned since 2019 with no security updates or compatibility fixes. For new projects, use Salesforce's current Marketing Cloud SDKs or REST API clients. The unmaintained suds-jurko dependency and lack of Python version support beyond 3.3 create long-term risk.

Install

salesforce-fuelsdk on PyPI

pip install salesforce-fuelsdk

uv add salesforce-fuelsdk

poetry add salesforce-fuelsdk

Installing Salesforce-FuelSDK

Before you install

Low install friction with a pure-wheel distribution, but the project is archived and abandoned since 2019—no maintenance or security updates are being applied. The three runtime dependencies (pyjwt, requests, suds-jurko) are stable but suds-jurko itself is unmaintained.

License in practice

MIT license is permissive and imposes no restrictions on commercial or private use, modification, or redistribution.

Quickstart

pip install Salesforce-FuelSDK

import FuelSDK
myClient = FuelSDK.ET_Client()
list_obj = FuelSDK.ET_List()
list_obj.auth_stub = myClient
response = list_obj.get()

Requires Salesforce Marketing Cloud credentials (Client ID and Client Secret) configured via config.python file or FUELSDK_CLIENT_ID and FUELSDK_CLIENT_SECRET environment variables.

Verify before relying

• Whether suds-jurko dependency has known security or compatibility issues with modern Python versions beyond 3.3.
• Current compatibility with modern Salesforce Marketing Cloud API endpoints and authentication flows.
• Whether the SOAP API layer remains functional given the age of the WSDL bindings.

Package facts

Evidence: Salesforce_FuelSDK-1.3.0-py3-none-any.whl

Tags

More Libraries packages