Events

View Events related to your orders.

An event is created whenever a webhook is triggered. For example, if a webhook is created that listens to letter.updated events and the delivery status of a letter is updated, an event detailing the updated fields will get created.

List Events

print_mail.events.list() -> SyncSkipLimit[Event]

GET/print-mail/v1/events

ModelsExpand Collapse

class Event: …

id: str

A unique ID prefixed with event_.

created_at: datetime

The UTC time at which this event was created.

formatdate-time

live: bool

true if this is a live mode event else false.

object: Literal["event"]

Always event.

type: Literal["letter.created", "letter.updated", "postcard.created", 18 more]

The type of event that a Webhook can listen for and that an Event represents.

One of the following:

"letter.created"

"letter.updated"

"postcard.created"

"postcard.updated"

"self_mailer.created"

"self_mailer.updated"

"cheque.created"

"cheque.updated"

"box.created"

"box.updated"

"snap_pack.created"

"snap_pack.updated"

"return_envelope_order.created"

"return_envelope_order.updated"

"tracker.visited"

"campaign.created"

"campaign.updated"

"virtual_mailbox_item.created"

"postal_statement.created"

"document.created"

"document.updated"

data: Optional[Dict[str, object]]

The data of the resource associated with this event.

updated_fields: Optional[Dict[str, object]]

A record containing the updated fields of the resource associated with this event.