sendkit 1.0.0

Python SDK for the SendKit email API

SendKit Python SDK

Official Python SDK for the SendKit email API.

Installation

pip install sendkit

Usage

Create a Client

from sendkit import SendKit

client = SendKit("sk_your_api_key")

Send an Email

result = client.emails.send(
    from_="[e-mail]",
    to="[e-mail]",
    subject="Hello from SendKit",
    html="<h1>Welcome!</h1>",
)

print(result["id"])

Send a MIME Email

result = client.emails.send_mime(
    envelope_from="[e-mail]",
    envelope_to="[e-mail]",
    raw_message=mime_string,
)

Error Handling

API errors raise SendKitError:

from sendkit import SendKit, SendKitError

client = SendKit("sk_your_api_key")

try:
    client.emails.send(...)
except SendKitError as e:
    print(e.name)        # e.g. "validation_error"
    print(e.message)     # e.g. "The to field is required."
    print(e.status_code) # e.g. 422

Configuration

# Read API key from SENDKIT_API_KEY environment variable
client = SendKit()

# Custom base URL
client = SendKit("sk_...", base_url="https://custom.api.com")