Event catalogue
GET /events returns this list at runtime.
| Event | Fired when | data |
|---|---|---|
ticket.created | A ticket is created | ticket |
ticket.updated | A ticket field is updated (changes.field, oldValue, newValue) | ticket |
ticket.state_changed | Ticket state changes | ticket |
ticket.assigned | Assignee or group changes | ticket |
ticket.comment_added | A comment is added (changes.commentHtml) | ticket |
ticket.comment_removed | A comment is removed | ticket |
ticket.attachment_added | An attachment is added (changes.fileName) | ticket |
ticket.attachment_removed | An attachment is removed | ticket |
ticket.approved | An approval step is approved | ticket |
ticket.rejected | An approval step is rejected (changes.note) | ticket |
ticket.deleted | A ticket is deleted | ticket (id, number, boardId) |
ticket.sla_breached | An SLA target is breached (changes.metric, changes.policy) | ticket |
kb.article_approved | A knowledge base article is approved | article summary |
kb.article_rejected | A knowledge base article is rejected | article summary |
user.created | A user activates their account | user |
automation.triggered | An automation rule runs its Send a webhook action (changes.field is the rule name, changes.note its optional note) | ticket |
webhook.test | You press Test on a subscription | test message |
Filtering on field values
A subscription filters by event type and board only. To react to a narrower condition, such as priority is High or the customer is in a given company, build an automation rule with those conditions and give it the Send a webhook action, choosing this subscription as the target. The rule's conditions do the filtering, and the delivery arrives as automation.triggered.
A targeted delivery ignores the subscription's own event and board filters, because the rule already decided that it should be sent.
Board filters apply to ticket.* events. Events are delivered in the order they were queued per subscription, but ordering across retries is not guaranteed — use occurredAt when it matters.