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.
Manage subscriptions
Subscriptions are project-scoped and managed through the Public API. Every 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.
Webhooks tag.
Verify the signature
Every request carries 3 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.
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.