Skip to main content
Use a public key for tracking events, and a secret key for listing event names.

​
Track an event (events.track)

from mailrify import Mailrify

tracker = Mailrify("pk_your_public_key")

result = tracker.events.track(
    email="[email protected]",
    event="purchase",
    subscribed=True,
    data={"product": "premium", "amount": 99},
)

print(result.contact, result.event, result.timestamp)

​
List event names (events.get_names)

from mailrify import Mailrify

client = Mailrify("sk_your_secret_key")

event_names = client.events.get_names()
print(event_names)

​
Key-type mismatch example

from mailrify import Mailrify
from mailrify.exceptions import AuthenticationError

client = Mailrify("pk_your_public_key")

try:
    client.events.get_names()
except AuthenticationError as error:
    print(error.message)

​
Async equivalents

from mailrify import AsyncMailrify


async def run() -> None:
    async with AsyncMailrify("pk_your_public_key") as tracker:
        result = await tracker.events.track(email="[email protected]", event="signup")
        print(result.event)

    async with AsyncMailrify("sk_your_secret_key") as client:
        names = await client.events.get_names()
        print(names)
The Python SDK exposes events.get_names() only (there is no list_names() alias). See endpoint details in the Track event API reference and List event names API reference.