Skip to main content
We know that each implementation will vary. Please reach out and let us know if you need any support.

Set up the integration

1
Open the Workspace name dropdown and click Workspace settings.
2
Navigate to Integrations.
3
Click Enable next to Webhook.
4
Click Connect in the modal.
5
Define a webhook title.
6
Define the webhook URL and enable “Notify when bug report is opened.” This is the location of the webhook used by your bug tracker.
7
When an issue is created, your endpoint will receive POST requests with a JSON body (Content-Type: application/json). Here’s the expected structure and an example payload.

Expected JSON Body Fields

The primary data is in the request body:
  • id (string): Unique bug report ID.
  • title (string): Bug report title.
  • description (string): Detailed description (may contain newlines/links).
  • url (string): Link to view the bug report in QA Wolf.
  • event (string): bug-report-opened.

Example Payload

This example shows the full request structure your endpoint will receive:
JSON

Authentication

If username and password are set, those will be used for basic HTTP authorization when performing the POST request against your webhook.
8
Enable the “Notify when bug report is closed” toggle:
9
Make your webhook respond to the POST request with a payload containing these fields:
  • externalId (string): ID of the issue for the QA Wolf bug report in your issue tracker. It will be used to identify issues that will need to be updated in the future.
  • humanId (string): Human-friendly issue ID that will be used on QA Wolf UI, Slack messages and other integrations.
  • url (string): Link to the issue.
10
When a bug report is closed, your endpoint will receive POST requests with a JSON body (Content-Type: application/json). Here’s the expected structure and an example payload.

Expected JSON Body Fields

The primary data is in the request body:
  • externalId (string): The ID of the issue associated with the closed bug report.
  • event (string): bug-report-closed.
Last modified on April 18, 2026