Skip to main content

Events

Events are central to Inngest, and represent activity in both your systems and 3rd party systems. They trigger workflows, update contacts, and offer complete insight into your business.

Next up, look at the event format and how to send events.

Events power everything at Inngest. We ingest events from your own systems, your third party services, and from your websites. Events allow us to trigger workflows, aggregate your user data, segment users, and provide insights into your systems.

What are events?

Events are payloads which capture any activity from your own applications (frontend, server, or mobile) and from your partner services (eg. Stripe, Zendesk, GitHub).

For example, you may trigger an event when:

  • A user signs up (signup.created)
  • A user purchases a product or subscription (payment.received)
  • A customer replies to customer support (ticket.updated).

An example

An example event may look like this:

{
"name": "ticket.updated",
"data": {
"ticket_id": 189325,
"comment": "Thanks for sending me the return label!",
"status": "open"
},
"user": {
"external_id": 83561,
"email": "test@example.com"
},
"v": "2021-09-15.01"
}

This event references a ticket being updated with some ticket data (ticket_id, comment, and status), user data (external_id, email), and a version.

This event format is standard across our systems. It allows us to extract:

  • The event name, to distinguish between events
  • Event data, which can be referenced in your workflows
  • User information, allowing us to show you a 360 view of your contacts entire history

Sending events

You can send us events using:

For more information, view the event source documentation.