Skip to main content
This page describes legacy triggers. See Triggers for the current documentation.
Use this guide if your CI system can’t run Node.js. If it can, use Node.js SDK instead.

Requirements

  • Access to a QA Wolf workspace with at least one environment configured
  • The ability to make HTTP requests from your CI environment
  • Admin access to your CI system’s secret or environment variable storage

How to connect QA Wolf to your CI system

1

Add the QAWOLF_API_KEY secret

Store your QA Wolf API key as a secret named QAWOLF_API_KEY in your CI system.
2

Add the deploy notification to your pipeline

Add a step that runs after your deployment is healthy.
Replace $GIT_BRANCH and $GIT_COMMIT_SHA with the variable names your CI system provides for the current branch and commit SHA, and deployment_type with the value your QA Wolf representative provides. Set hosting_service to where your code is hosted, not where your pipeline runs.
A 200 response does not guarantee a run was created. Inspect the response body to confirm. See webhooks/deploy_success for full response details.
3

Verify the integration

Trigger your CI pipeline with a new deployment. Confirm the notify step completes without errors, and that a new run appears in QA Wolf under the expected environment.
Last modified on September 18, 2026