Skip to main content
If your repositories are hosted on GitHub.com or GitHub Enterprise Cloud, this is the recommended setup. The integration connects directly to your QA Wolf environments using GitHub Actions to notify QA Wolf of new deployments.
If your team self-hosts GitHub Enterprise Server without internet access, or has disabled GitHub Actions by policy, use the QA Wolf CI SDK instead.
Make sure you have:
  • Access to your QA Wolf workspace.
  • Admin access to your GitHub repository.

​
Connect QA Wolf to GitHub

1

Enable the GitHub integration

Enable the GitHub integration from Workspace Settings → Integrations in QA Wolf.
2

Install the QA Wolf GitHub App

Install the QA Wolf GitHub App on the repositories you want connected.
Your user cannot be a member of multiple GitHub orgs.
1

Generate a QAWOLF_API_KEY

Generate a QAWOLF_API_KEY from Workspace Settings → Integrations → API Access.
2

Add it as a repository secret

Add it as a QAWOLF_API_KEY secret in your repository’s Settings → Secrets and variables → Actions.

​
Add the GitHub Actions workflow

QA Wolf’s official GitHub Action, Notify QA Wolf on Deploy, notifies QA Wolf whenever a new deployment is ready for testing.
This must be done for every repository you want connected to CI/CD.
Add a workflow file (e.g. .github/workflows/deploy.yml) with the following, replacing deployment-type and deployment-url with your actual values. To get the value for deployment-type, reach out to QA Wolf.

​
Verify the integration

1

Push a commit

Push a commit to trigger a deployment.
2

Confirm the run appears

Confirm a new run appears in QA Wolf under the expected environment.
Last modified on September 16, 2026