List Events
gorgias_list_eventsRead-only
Retrieve paginated lists of Gorgias events, filterable by object, user, type, and creation date range to track helpdesk activity.
Instructions
GET /api/events — List events, cursor-paginated and ordered by creation date (most recent first). Supports filtering by object, user, event type, and creation datetime range.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of events to return per page (1-100, default 30) | |
| types | No | Filter events by event type names. The Gorgias API expects an array of strings. Common values include 'ticket-created', 'ticket-updated', 'ticket-deleted', 'ticket-message-created', 'customer-created', etc. — there are 100+ possible values; see the Gorgias Event Object documentation for the full list. | |
| cursor | No | Pagination cursor. Pass the value of next_cursor from a previous response to retrieve the next page | |
| order_by | No | Sort order (default: 'created_datetime:desc') | |
| user_ids | No | Filter events by the IDs of the users who triggered them. The Gorgias API expects an array of integers. | |
| object_id | No | Filter events by the ID of the associated object (e.g., ticket ID, customer ID) | |
| object_type | No | Filter events by the type of the associated object. The API requires object_id when object_type is provided. | |
| created_datetime | No | Filter events by creation datetime. Object of comparator -> ISO 8601 datetime, e.g. { gte: '2026-01-01T00:00:00Z', lt: '2026-02-01T00:00:00Z' }. |