Quick Reference
Events
Subscribe to either event, or both.run.finished accepts an outcome filter so you only receive the runs you care about. It is ignored for run.started.
The outcome follows the build result. An interrupted or timed-out run counts as
failed when it has any failed test case, quarantined ones included, or a critical test that passed only on retry. Otherwise it counts as passed.
Manage subscriptions
Subscriptions are project-scoped. Manage them in the app or through the Public API. In the app, go to Project Settings → Integrations and open the Webhooks tile. Add webhook sets the URL, the events, and Trigger on: Any outcome, Failures only, or Passing only. Each endpoint has View delivery log to inspect its delivery attempts. Every Public API request uses atd_pat_ personal access token as a Bearer token.
Reads work for any member of the organization. Creating, updating, and deleting require an owner or admin role; other roles get
403 FORBIDDEN.
Subscriptions accept either spelling of an event and store the older one, so a subscription created with ["run.finished"] reads back as ["RUN_FINISHED"] until 11 December 2026. That is expected, not a failed write.
- curl
- PowerShell
Webhooks tag.
Verify the signature
Every request carries 4 headers.
The signature is an HMAC-SHA256 of
<timestamp>.<raw request body>, keyed with your signing secret. Compute it over the raw bytes you received: parsing and re-serializing the JSON changes the body and breaks the comparison.
Delivery and retries
Respond with any2xx status to acknowledge a delivery. TestDino does not read the response body, and redirects are not followed.
A delivery that fails is retried 4 times, for 5 attempts total.
After 5 consecutive failed deliveries, the subscription is disabled and stops receiving events. Re-enable it by setting
active to true, which also clears the failure count.
Inspect what happened with the deliveries endpoint, which returns each attempt with its status, HTTP status code, and response time.
- curl
- PowerShell
Related
API Reference
Every endpoint, grouped by resource.
Generate API Keys
Create and scope a
td_pat_ token.Developer Portal
The OpenAPI spec, MCP server, and quickstarts.