Flaky test webhooks in Trunk

Trunk provides webhooks for you to build custom integrations to automate workflows, like notifying your team when a test becomes flaky or automatically creating tickets to investigate flaky tests. Trunk provides built-in connectors for Linear and Jira to automate ticket creation, and webhooks let you build custom integrations for use cases that are not supported out of the box.

For Merge Queue webhook events (pull_request.* and pull_request_batch.*), see the Merge Queue webhooks reference.

Svix powers webhooks for Trunk. You’ll be using Svix to configure webhooks and you should familiarize yourself with the Svix App Portal docs to learn more.

Supported Events

Trunk lets you create custom workflows with event-triggered webhooks. Flaky Tests events are named with a test_case prefix. You can find all the events that Trunk supports in the event catalog:

Webhook Events | trunk.io - Svix

www.svix.com

Trunk publishes the following Flaky Tests event types to Svix. Each event includes a full JSON schema with field descriptions visible in the Svix app portal.

`test_case.monitor_status_changed`

Emitted when a monitor activates or resolves for a test case.

Field	Type	Description
`type`	string	Always `test_case.monitor_status_changed`
`timestamp`	string (ISO 8601)	When the event occurred
`monitor.id`	string (UUID)	Unique identifier for the monitor
`monitor.type`	string	The type of monitor (e.g., `pass_on_retry`)
`monitor.status`	string	Current monitor status (`active` or `resolved`)
`evidence`	object	Data supporting the status change; structure varies by monitor type
`repository.id`	string (UUID)	Unique identifier for the repository
`repository.html_url`	string	URL of the repository
`test_case.id`	string (UUID)	Stable unique identifier for the test
`test_case.name`	string	Name of the test
`test_case.classname`	string	Test classname
`test_case.file_path`	string	File path of the test
`test_case.html_url`	string	URL to the test detail page in Trunk
`test_case.codeowners`	array of strings	Code owners associated with the test
`test_case.quarantined`	boolean	Whether the test is quarantined
`test_case.variant`	string	Test variant name

`v2.test_case.status_changed`

Emitted when a test case changes status (e.g., becomes flaky or is resolved), as triggered by a monitor.

Field	Type	Description
`type`	string	Always `v2.test_case.status_changed`
`timestamp`	string (ISO 8601)	When the event occurred
`previous_status`	string	The prior status of the test case
`new_status`	string	The updated status of the test case
`triggered_by.monitor_id`	string (UUID)	Unique identifier of the triggering monitor
`triggered_by.monitor_type`	string	Type of monitor that triggered the change
`triggered_by.monitor_status`	string	Status of the monitor at the time of the trigger
`repository`	object	See `repository` fields above
`test_case`	object	See `test_case` fields above

The original test_case.status_changed event is being phased out in favor of v2.test_case.status_changed. v2 intentionally omits aggregate metrics like failure_rate_last_7d. To enrich a status-change webhook with current metrics, call flaky-tests/get-test-details from your webhook handler using the test_case.id from the payload.

`test_case.quarantining_setting_changed`

Emitted only when a quarantining setting is manually overridden to ALWAYS_QUARANTINE or NEVER_QUARANTINE. It does not fire when Trunk auto-quarantines a test based on flakiness — to react to auto-quarantine, listen to v2.test_case.status_changed and check new_status == "FLAKY". The full payload schema is available in the Svix event catalog linked above.

`test_case.investigation_completed`

Emitted when an AI-powered flaky test analysis finishes for a test case.

Field	Type	Description
`type`	string	Always `test_case.investigation_completed`
`investigation_id`	string (UUID)	Unique identifier for the investigation
`trigger`	string	How the investigation was initiated. One of `AUTOMATIC`, `MANUAL`, or `MCP`
`confidence`	number	Overall confidence score (0-1) for the findings
`created_at`	string (ISO 8601)	When the investigation completed
`markdown_summary`	string	Markdown-formatted summary of findings and recommendations
`failure_message`	string	The original failure message that triggered the investigation
`facts`	array	Facts discovered during the investigation
`facts[].fact_type`	string	Category of the fact (e.g., `GIT_BLAME`)
`facts[].content`	string	Detailed description with citations to supporting evidence
`facts[].confidence`	number	Confidence score (0-1) for this individual fact
`repository`	object	See `repository` fields above
`test_case`	object	See `test_case` fields above

Citations in markdown_summary and facts[].content are delivered as fully rendered links to the supporting evidence, so you can consume these fields directly without resolving placeholder tags. test_case.investigation_completed fires only when an AI investigation finishes — it is not a general status-change signal. For “this test just became flaky” reactions (Linear ticket creation, Slack alerts, and so on), subscribe to v2.test_case.status_changed instead. Delivery reliability. If the webhook delivery provider rate-limits a request, Trunk automatically retries with exponential backoff, so a transient spike rarely drops an event. This applies to every Flaky Tests webhook event and needs no configuration on your side. You can also find guides for specific examples here:

Flaky Tests

Webhooks

Supported Events

Webhook Events | trunk.io - Svix

`test_case.monitor_status_changed`

`v2.test_case.status_changed`

`test_case.quarantining_setting_changed`

`test_case.investigation_completed`

Alert When a Test Escalates

Send a Slack Message

Create a GitHub Issue

Send a Microsoft Teams Message

Create a Linear Issue

Create a Jira Issue

​Supported Events

Webhook Events | trunk.io - Svix

​test_case.monitor_status_changed

​v2.test_case.status_changed

​test_case.quarantining_setting_changed

​test_case.investigation_completed

Alert When a Test Escalates

Send a Slack Message

Create a GitHub Issue

Send a Microsoft Teams Message

Create a Linear Issue

Create a Jira Issue

Supported Events

`test_case.monitor_status_changed`

`v2.test_case.status_changed`

`test_case.quarantining_setting_changed`

`test_case.investigation_completed`