Free tools Windows power users keep installed
One-click scans. No signup required.
Cypress Cloud webhooks send selected run events as JSON HTTP POST requests to an endpoint you control. Configure the event and destination in Cypress Cloud, map payload fields into your workflow, and add downstream filters for actions such as Slack alerts, tickets, deployment gates, or internal reporting. Use a webhook when Cypress’s built-in integrations do not provide the wording, fields, routing, or destination you need.
Decide whether you need a webhook
Start by checking whether a native integration already covers the task. Cypress’s built-in Slack integration supports channel and direct-message notifications, run-status choices, flaky-test alerts, tag or run-group filters, and configurable content sections. The built-in GitHub integration reports results through commit checks and pull-request comments. If those options meet your needs, they avoid an extra receiver or automation step. See Cypress’s Slack integration documentation and GitHub integration documentation.
Use a custom webhook when you need different message content, custom conditions, another destination, or a workflow Cypress’s built-in integrations do not cover. Cypress describes use cases including updating a dashboard, opening a ticket, gating a deployment, and forwarding results into an internal system. Its use-case guide was updated September 29, 2026; third-party workflow features and plan requirements can change, so verify them with the destination service. Cypress Webhooks Integration.
Choose the event and destination
Cypress Cloud documents three webhook event types. A completed run can have one of five statuses; make your downstream logic account for all outcomes rather than treating only a failed test run as unsuccessful.
Do these 3 things before closing this tab:
1Repair Windows errors before they cause bigger problems2Fix the driver behind crashes, sound loss and screen glitches3Clear out junk files and repair common Windows errors#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
| Event | What it signals | Payload consideration |
|---|---|---|
run.completed |
A Cypress run has completed. Status can be passed, failed, errored, timedOut, or cancelled. |
Useful top-level fields include status, projectName, runNumber, runUrl, totalFailed, and commitBranch. |
run.accessibility.completed |
An accessibility report has completed. | Report data is nested; some workflow builders cannot map nested objects or arrays directly. |
run.uiCoverage.completed |
A UI Coverage report has completed. | Report data is nested; transformation may be needed before passing it to a simple workflow builder. |
For Slack, Teams, or another automation platform, create an inbound-webhook trigger at the destination and use its generated URL as the Cypress Payload URL. Other documented patterns include sending commitSha, status, and runUrl through Zapier, Make, or n8n to a GitHub Actions repository_dispatch workflow; invoking a deployment provider’s build hook only for passing runs; or routing failures into ticketing or incident workflows. These are integration patterns, not guarantees that each service supports every feature on every plan.
Configure a webhook in Cypress Cloud
- In the Cypress Cloud project, open Settings → General → Webhooks, then choose Add webhook.
- Paste the destination’s inbound URL into Payload URL. It must be publicly reachable and accept HTTP POST requests. Prefer HTTPS. Cypress blocks private, loopback, and internal destinations, and does not follow redirects.
- Select one or more event types:
run.completed,run.accessibility.completed, orrun.uiCoverage.completed. - Set a signing secret and, if needed, a custom authorization header. Store the secret securely; Cypress shows it only once. A manually entered signing secret must be at least 16 characters.
- Save the webhook, then use Cypress Cloud’s Send test control to check the destination and payload handling.
Only Project Owners, Admins, and Team Admins can create, edit, enable, disable, test, or redeliver project webhooks. Cypress documents a maximum of five webhooks per project. See the current webhook setup and permissions guidance.
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
Map payload fields and define conditions
For a Slack Workflow Builder example, configure the workflow to start with a webhook, define data variables using the incoming top-level payload keys, then compose a message from those values. Include a link to runUrl so recipients can open the run rather than relying on text alone. Useful values include status, projectName, runNumber, commitBranch, totalTests, and totalFailed. Cypress’s guide also demonstrates filtering by status or failure count when not every run should trigger the same action. See Cypress’s webhook use-case guide.
Be explicit about the status logic. For example, an alert intended to catch every non-passing run should consider failed, errored, timedOut, and cancelled, not just failed. For accessibility and UI Coverage events, inspect the nested payload shape and use an intermediate transformation step if the destination cannot map arrays or nested objects.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Repair Windows errors before they cause bigger problemsFix Now →Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
Test the complete path
- Send Cypress Cloud’s synthetic test delivery and confirm that the endpoint accepts the request, parses the JSON, and produces the intended downstream result.
- Exercise your workflow’s conditions, including the statuses or branches that should be filtered out. A successful connection test alone does not prove the conditions behave correctly for your project.
- After enabling the workflow, verify it against a real Cypress run before relying on it for deployments or incident response.
- Review recent webhook deliveries in Cypress Cloud when troubleshooting; the delivery history shows attempt status. A failed or exhausted delivery can be manually redelivered.
Test payloads are realistic but fabricated, and Cypress does not retry test sends. Manual redelivery retains the original event ID, so receivers should deduplicate it just like an automatic retry.
Secure the receiver and handle retries
Verify requests
When a signing secret is configured, verify the X-Cypress-Signature against the raw request body, using a constant-time comparison. Validate the timestamp and reject stale requests as appropriate. The delivery headers also include X-Cypress-Event, X-Cypress-Event-Id, X-Cypress-Event-Version, X-Cypress-Request-Id, X-Cypress-Timestamp, and X-Cypress-Idempotency-Key. Keep the payload URL secret if the destination cannot verify raw-body HMAC, and use its authentication controls where available; this is weaker than signature verification.
Rank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Make processing idempotent
Use the stable event ID or idempotency key to recognize a repeated event. The request ID changes for each delivery attempt, so do not use it as the deduplication key. Record processed event identifiers before performing a non-repeatable action such as opening a ticket or starting a deployment.
Return promptly and understand retry behavior
Cypress times out each attempt after 10 seconds. It retries transport or network errors and HTTP 408, 429, and 5xx responses, with exponential backoff and jitter, for up to ten total attempts: the initial request plus as many as nine retries. A completed 3xx response, other 4xx responses, and blocked URLs are permanent failures. Make the receiver acknowledge promptly and do slower downstream work asynchronously where possible. Cypress documents these delivery rules in its webhook documentation.
Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
Troubleshoot common failures
- URL blocked or unreachable: Confirm the endpoint is publicly reachable, not a private, loopback, or internal address, and accepts POST. Use HTTPS and remove redirect-based routing because Cypress does not follow redirects.
- Delivery times out: The endpoint must respond within the 10-second attempt timeout. Acknowledge the request quickly, queue longer processing, and inspect the delivery history.
- Webhook never retries: A redirect or non-retryable client error is treated as a permanent failure. Return an appropriate success response after accepting valid work; use retryable responses only when the request should be attempted again.
- Duplicate tickets, alerts, or jobs: Automatic retries and manual redelivery can repeat an event. Deduplicate on the stable event ID or idempotency key, not the per-attempt request ID.
- Signature verification fails: Compute the HMAC over the exact raw body before JSON parsing or reserialization, use the configured secret, and compare signatures in constant time. Check timestamp handling if stale requests are rejected.
- Slack variables are missing: Confirm that the variable names match top-level payload keys. Accessibility and UI Coverage event reports contain nested data and arrays that Slack Workflow Builder may not map directly; add a transformation step or begin with
run.completed. - Test succeeds but real behavior is wrong: Cypress’s test delivery contains fabricated data and is not retried. Validate the downstream filters and message using a real run before depending on the workflow.
Or skip the browser setup
If a workflow needs a clean screenshot of a page as part of its output or follow-up, ScreenshotNeo provides a one-request screenshot API; it is separate from Cypress Cloud webhook delivery. A GET request returns an image or PDF. Its API accepts consent banners as a visitor and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; those steps can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers identify the page verdict and billing status. ScreenshotNeo also has an MCP server with take_screenshot, get_page_info, and capture_pdf tools for AI agents.
Example cURL call (replace the URL and key):
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpSee the ScreenshotNeo API documentation. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000. Sign up for 1,000 free screenshots a month with no card.
Frequently asked questions
Can I use one webhook for more than one Cypress event?
Yes. Select one or more event types when configuring the webhook, then route or filter requests using the event information and payload appropriate to each type.
Does a webhook replace Cypress Cloud’s Slack or GitHub integrations?
No. It is an additional route for custom destinations and logic. Prefer a built-in integration when its supported notifications or reporting already meet the need.
Recommended Free Tools
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
