pyrx-synapse 0.1.2

PYRX Synapse Python SDK — async + sync client for event tracking, contacts, and email

pyrx-synapse

Python SDK for the PYRX Synapse customer engagement platform. Provides both synchronous and asynchronous clients.

Requires Python 3.10+.

Installation

pip install pyrx-synapse

Quick Start

Sync

from pyrx_synapse import Synapse

with Synapse(api_key="gck_live_xxx", workspace_id="ws_xxx") as client:
    # Track an event
    client.track(external_id="user_123", event_name="purchase", attributes={"amount": 99.99})

    # Identify a contact
    client.identify(external_id="user_123", email="[e-mail]", properties={"tier": "pro"})

    # Send a transactional email
    client.send(
        template_slug="welcome",
        to={"user_id": "user_123", "email": "[e-mail]"},
        attributes={"first_name": "Jane"},
    )

Async

from pyrx_synapse import AsyncSynapse

async with AsyncSynapse(api_key="gck_live_xxx", workspace_id="ws_xxx") as client:
    await client.track(external_id="user_123", event_name="purchase")
    await client.identify(external_id="user_123", email="[e-mail]")

Features

• Synchronous and asynchronous clients
• Event tracking, contact management, template management, transactional email
• Webhook signature verification
• Automatic retry with exponential backoff
• Typed error classes for all API error types

Documentation

Full API reference and guides: synapse.pyrx.tech/developers/sdks/python

License

MIT