Skip to main content
MobileBoost sends a POST request with test results to your webhook endpoint every time a test suite completes. This lets you integrate results into your own systems: dashboards, alerting, ticketing, or custom reporting.

​
Setup

1

Prepare your endpoint

Set up an HTTP endpoint that accepts POST requests with a JSON body. This can be any server, serverless function, or third-party service that accepts incoming webhooks.
2

Configure the webhook URL

Go to Account > Settings in QA Studio and find the Webhook URL to be called after test suite run field. Enter your endpoint URL.
3

Add authorization (optional)

If your endpoint requires authentication, enter the value in the Webhook authorization header field. MobileBoost includes this value in the Authorization header of every request.

​
Payload

After each test suite run, MobileBoost sends a POST request to your configured URL with a JSON payload containing the full results.

​
Fields

FieldTypeDescription
totalTestsintegerTotal number of tests in the suite
succeededTestsarrayList of tests that passed
failedTestsarrayList of tests that failed
blockedTestsarrayList of tests that were blocked from executing
appInfostringApplication name
appVersionCodestringApplication version code
appVersionNamestringApplication version name
platformstringTarget platform (android or ios)
bundlestringApplication bundle identifier
uploadIdstringID of the uploaded build
triggerstringHow the run was triggered (e.g., API)
metaDataobjectCustom metadata attached to the execution
testSuiteIdstringUnique identifier for the test suite run
startTimeInEpochintegerSuite start time as Unix timestamp

​
Test result fields

Each test in succeededTests, failedTests, and blockedTests contains:
FieldTypeDescription
idstringTest ID
titlestringTest name
statusstringResult status (succeeded, failed, blocked)
statusMessagestringDetail message, especially for failures
recordingstringURL to the video recording of the test run
platformstringPlatform the test ran on
devicestringDevice model
osstringOS version
orientationstringScreen orientation
localestringDevice locale
tagsarrayTags assigned to the test
startTimeInEpochintegerTest start time as Unix timestamp
finishTimeInEpochintegerTest finish time as Unix timestamp

​
Example payload

{
  "totalTests": 1,
  "succeededTests": [],
  "failedTests": [
    {
      "id": "teXiuNg4TLL9ioHIct5H",
      "startTimeInEpoch": 1696263692,
      "finishTimeInEpoch": 1696263713,
      "title": "3sec failing",
      "status": "failed",
      "statusMessage": "error detected: The installation of the app has failed, preventing the execution of the test steps.",
      "recording": "https://app.mobileboost.io/recording/jhn7urWc/runs/teXK9ioHIct5H",
      "platform": "android",
      "device": "pixel7",
      "orientation": "portrait",
      "os": "13.0",
      "coordinates": {},
      "locale": "fr_FR",
      "tags": ["test tag"]
    }
  ],
  "blockedTests": [],
  "appInfo": "Test App",
  "startTimeInEpoch": 1696263663,
  "appVersionCode": "1123",
  "appVersionName": "2.4.9",
  "platform": "android",
  "bundle": "com.test.app",
  "uploadId": "JbUOAOHLx99O2MYJc0LC",
  "trigger": "API",
  "metaData": {},
  "testSuiteId": "99a7a26d1c914f77916f35ca76291d82"
}