Webhook Events Reference | BetaTesting Answers & Support

This article lists all webhook event types available on BetaTesting, along with the data included in each event's payload. Subscribe to specific events when creating or editing a webhook on your Company Settings > Integrations page.

Review the up-to-date full webhook documentation available in the Swagger docs accessible from your BetaTesting Integrations -> Webhooks page.

Payload Structure

All webhook events share the same top-level structure:

{
  "event": "event.type.name",
  "timestamp": 1707123456,
  "data": { ... }
}

The data object varies by event type as described below.

Test Events

`test.status.changed`

Fired when a test's status changes (e.g., launched, paused, closed, completed).

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`status`	string	New status: `draft`, `pending_review`, `ready`, `in_progress`, `complete`, `closed`, `paused`

Issue Events

`issue.submitted`

Fired when a tester submits a new issue (bug report) on a test.

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`issueId`	integer	The new issue ID

`issue.updated`

Fired when an issue's status, priority, or notes are updated.

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`issueId`	integer	The updated issue ID

`issue.message.new`

Fired when a new message (comment) is posted on an issue.

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`issueId`	integer	The issue ID

Tester Events

`tester.status.changed`

Fired when a tester's status within a test changes (e.g., accepted, completed, removed, opted out).

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`testerId`	integer	The tester ID
`testerEmail`	string	The tester's email address
`status`	string	New status: `applied`, `accepted`, `behind`, `opt_out`, `removed`, `complete`

`tester.payment.processed`

Fired when a tester's reward payment has been processed.

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`testerId`	integer	The tester ID
`testerEmail`	string	The tester's email address

Activity Events

`activity.submitted`

Fired when a tester submits a response to an activity (survey/task).

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`testerId`	integer	The tester ID
`testerEmail`	string	The tester's email address
`activityId`	integer	The activity ID

`activity.updated`

Fired when an activity's settings are updated (e.g., name, due date, duration).

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`activityId`	integer	The activity ID

Message Events

`message.tester.new`

Fired when a new message is sent to a tester within a test.

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`testerId`	integer	The tester ID
`testerEmail`	string	The tester's email address

Community Events

`community.tester.joined`

Fired when a new tester joins your tester community.

Payload data:

Field	Type	Description
`testerId`	integer	The tester ID
`testerEmail`	string	The tester's email address

`community.tester.removed`

Fired when a tester is removed from your community.

Payload data:

Field	Type	Description
`testerId`	integer	The tester ID
`testerEmail`	string	The tester's email address

`community.tester.tagged`

Fired when tags are added to or removed from a community tester.

Payload data:

Field	Type	Description
`testerId`	integer	The tester ID
`testerEmail`	string	The tester's email address
`tags`	array	List of tag names involved
`action`	string	`added` or `removed`

Shipment Events

`shipment.updated`

Fired when a shipment's tracking status is updated.

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`testerId`	integer	The tester ID
`testerEmail`	string	The tester's email address

`shipment.confirmed`

Fired when a shipment delivery is confirmed.

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`testerId`	integer	The tester ID
`testerEmail`	string	The tester's email address

`shipment.exception`

Fired when a shipment encounters a delivery exception (e.g., returned, lost, damaged).

Payload data:

Field	Type	Description
`testId`	integer	The test ID
`testName`	string	The test name
`testerId`	integer	The tester ID
`testerEmail`	string	The tester's email address

Quick Reference

Event	Description
`test.status.changed`	Test status updated
`issue.submitted`	New issue reported
`issue.updated`	Issue status/priority changed
`issue.message.new`	New comment on an issue
`tester.status.changed`	Tester status changed in a test
`tester.payment.processed`	Tester reward payment processed
`activity.submitted`	Tester submitted an activity response
`activity.updated`	Activity settings updated
`message.tester.new`	Message sent to a tester
`community.tester.joined`	Tester joined the community
`community.tester.removed`	Tester removed from community
`community.tester.tagged`	Tags added/removed on a community tester
`shipment.updated`	Shipment tracking status updated
`shipment.confirmed`	Shipment delivery confirmed
`shipment.exception`	Shipment delivery exception

BetaTesting ID Verifications for Testers

BetaTesting API & Webhooks Overview

API Reference Guide

Webhooks Overview & Setup

API & Webhooks FAQ & Troubleshooting