Skip to main content
TestDino webhooks POST a JSON payload to a URL you own when a Playwright test run starts or finishes. Each request is signed, so you can verify it came from TestDino before acting on it.

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 a td_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.
Store the signing secret immediatelyThe secret is returned in cleartext exactly once, in the create response. Later reads never include it. If you lose it, delete the subscription and create a new one.
Full request and response schemas are in the OpenAPI specification under the 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.
Compare with a timing-safe function, and reject any request whose timestamp is more than 300 seconds from your clock.

Delivery and retries

Respond with any 2xx 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.

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.