sendpulse-sdk 1.0.0

Developer friendly Python SDK for SendPulse Email REST API

SendPulse Python SDK

A lightweight, developer-friendly SDK for SendPulse Email REST API.

Install

pip install sendpulse-sdk

Quick Start

from sendpulse import SendPulseClient

client = SendPulseClient(
    client_id="your_client_id",
    client_secret="your_client_secret"
)

response = client.send_email(
    to_email="[e-mail]",
    subject="Hello from SendPulse SDK",
    body="<h1>Hello!</h1><p>Welcome to SendPulse transactional email integration.</p>",
    from_email="[e-mail]",
    from_name="Your Company Name"
)

print(response)

Bulk Emails

You can send bulk emails in a single request. The SDK normalizes the inputs and executes sending requests sequentially, returning a summary of the results.

emails = [
    {
        "to_email": "[e-mail]",
        "subject": "Hello User 1",
        "body": "<h1>Welcome</h1><p>This is HTML content.</p>",
        "type": "html"
    },
    {
        "to": "[e-mail]",
        "subject": "Hello User 2",
        "body": "This is plain text content.",
        "type": "text"
    }
]

response = client.send_bulk_emails(
    emails=emails,
    from_email="[e-mail]",
    from_name="Your Company Name"
)
print(response)

Health Check

To test connection or verify that your Client ID and Client Secret are correct:

health_info = client.health()
print(health_info)

Core Parameters

• client_id: OAuth Client ID (obtainable in your SendPulse account settings > API).
• client_secret: OAuth Client Secret (obtainable in your SendPulse account settings > API).
• api_url: Base URL for SendPulse REST API, defaults to https://api.sendpulse.com.
• timeout: Request timeout in seconds, defaults to 30.