{"library":"salesforce-fuelsdk-sans","title":"Salesforce Marketing Cloud Fuel SDK for Python (salesforce-fuelsdk-sans)","description":"The `salesforce-fuelsdk-sans` library is a community-maintained fork of the original Salesforce Marketing Cloud Fuel SDK for Python. It provides easy programmatic access to Salesforce Marketing Cloud's Fuel API Family services, encompassing both REST and SOAP APIs. The SDK streamlines common tasks such as acquiring and refreshing access tokens, managing token state, and determining appropriate API endpoints. The latest stable version, 1.3.1, was released in June 2022.","language":"python","status":"active","last_verified":"Sat May 16","install":{"commands":["pip install salesforce-fuelsdk-sans"],"cli":null},"imports":["from FuelSDK import ET_Client"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom FuelSDK import ET_Client\n\n# Configure environment variables (recommended for production)\n# export FUELSDK_CLIENT_ID='YOUR_CLIENT_ID'\n# export FUELSDK_CLIENT_SECRET='YOUR_CLIENT_SECRET'\n# export FUELSDK_AUTH_URL='YOUR_AUTH_TENANT_SPECIFIC_ENDPOINT'\n# export FUELSDK_BASE_API_URL='YOUR_REST_TENANT_SPECIFIC_ENDPOINT'\n# export FUELSDK_SOAP_ENDPOINT='YOUR_SOAP_TENANT_SPECIFIC_ENDPOINT'\n\ntry:\n    # Initialize ET_Client. Pass False for debug, False for account_id (unless using multi-org)\n    # Configuration can be passed as a dictionary, read from ~/.fuelsdk/config.python,\n    # or via environment variables (as shown below).\n    myClient = ET_Client(False, False)\n\n    # Example: Retrieve a list of lists\n    etList = myClient.create_object('List')\n    etList.props = {'Name': 'My New List', 'Description': 'Created via FuelSDK-Sans'}\n    results = etList.post()\n\n    if results.status:\n        print(f\"Successfully created list: {results.results[0]['NewID']}\")\n    else:\n        print(f\"Error creating list: {results.results[0]['ErrorMessage']}\")\n        print(f\"Full response: {results.results}\")\n\n    # Example: Get all lists\n    # etList = myClient.create_object('List')\n    # results = etList.get()\n    # if results.status:\n    #     print(f\"Found {len(results.results)} lists.\")\n    #     for lst in results.results:\n    #         print(f\"  List Name: {lst['ListName']}, ID: {lst['ID']}\")\n    # else:\n    #     print(f\"Error retrieving lists: {results.results[0]['ErrorMessage']}\")\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")\n    print(\"Ensure environment variables or config file are correctly set.\")\n","lang":"python","description":"This quickstart demonstrates how to initialize the `ET_Client` and perform a basic API call, such as creating a new list. It relies on environment variables for authentication credentials, which is a recommended practice. The `ET_Client` manages access token acquisition and refresh automatically.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":"1.3.1","pypi_latest":"1.3.1","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":2.3,"avg_import_s":0.71,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"salesforce-fuelsdk-sans","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.7,"mem_mb":12.8,"disk_size":"23.1M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"salesforce-fuelsdk-sans","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.4,"import_time_s":0.49,"mem_mb":12.8,"disk_size":"24M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"salesforce-fuelsdk-sans","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.85,"mem_mb":13.4,"disk_size":"25.1M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"salesforce-fuelsdk-sans","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.3,"import_time_s":0.77,"mem_mb":13.4,"disk_size":"26M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"salesforce-fuelsdk-sans","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.77,"mem_mb":13.9,"disk_size":"16.8M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"salesforce-fuelsdk-sans","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2,"import_time_s":0.81,"mem_mb":13.8,"disk_size":"17M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"salesforce-fuelsdk-sans","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.8,"mem_mb":15,"disk_size":"16.5M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"salesforce-fuelsdk-sans","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2,"import_time_s":0.76,"mem_mb":14.9,"disk_size":"17M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"salesforce-fuelsdk-sans","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.62,"mem_mb":12.4,"disk_size":"22.3M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"salesforce-fuelsdk-sans","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.7,"import_time_s":0.55,"mem_mb":12.4,"disk_size":"23M"}]}}