---
title: "buildDistro.newBuildAvailable"
method: POST
path: "buildDistro.newBuildAvailable"
tags: ["webhooks"]
---

# buildDistro.newBuildAvailable

`POST buildDistro.newBuildAvailable` (webhook)

When a new Build Distro build is available in a given bucket

## Payload

- object
  - `eventType` string, required: The type of event that was sent
  - `wasAutomatedByRunway` boolean, required: True if the event happened as a result of an action automated by Runway
  - `build` BuildDistroBuildEntity
    - `buildId` string, required: The id of the Build Distro build
    - `status` 'active' | 'expired' | 'deleted', required
    - `bucketName` string, required: The name of the build's bucket
    - `bucketId` string, required: The ID of the build's bucket
    - `artifactFileName` string: The name of the artifact file associated with the build
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `additionalTesters` BuildDistroBuildTester[], required: Any additional users or user groups assigned as testers for the build. Bucket members of the bucket this build is in are not included in the additional testers list.
      - `type` 'user' | 'userGroup', required: The type of tester
      - `id` string, required: The ID of the user or user group
    - `testerNotes` string: Optional tester notes for the build
    - `downloadURL` string: The url to download the build. The request to this URL must be authenticated with a Runway API key.
    - `ciBuildInfo` CIBuildEntity
      - `buildHash` string, required: A unique identifier for the build from a CI system, generated from the combination of integrationId and build identifier
      - `buildIdentifier` string, required: The identifier of the build as set by the integration provider
      - `integrationId` 'amazon' | 'apple' | 'google' | 'huawei' | 'samsung' | 'expo-eas' | 'appcenter-beta' | 'apple-beta' | 'google-beta' | 'firebase-beta' | 'runway-build-distro-beta' | 'appcenter-ci' | 'apple-ci' | 'azure-ci' | 'bitrise' | 'buildkite' | 'circleci' | 'codemagic' | 'generic-ci' | 'github-ci' | 'gitlab-ci' | 'jenkins' | 'travis' | 'launchdarkly' | 'optimizely' | 'statsig' | 'firebase-remote-config' | 'amplitude-experiment' | 'unleash' | 'asana' | 'azure-it' | 'jira' | 'linear' | 'pivotal' | 'shortcut' | 'monday' | 'slack' | 'microsoft-teams' | 'amplitude' | 'datadog-analytics' | 'mixpanel-analytics' | 'google-analytics' | 'apple-power-performance-metrics' | 'new-relic-analytics' | 'custom-analytics' | 'testrail' | 'qase' | 'testmo' | 'browserstack' | 'xray' | 'bugsnag' | 'firebase' | 'sentry' | 'embrace-stability-monitoring' | 'datadog-stability-monitoring' | 'dynatrace-stability-monitoring' | 'new-relic-stability-monitoring' | 'luciq-stability-monitoring' | 'luciq-analytics' | 'github-vcs-dist' | 'bitbucket' | 'github' | 'gitlab-vcs' | 'azure-vcs' | 'pagerduty-scheduling' | 'incident-io-scheduling' | 'opsgenie-scheduling' | 'crowdin' | 'lokalise' | 'jira-service-management-scheduling', required: The type of integration
      - `buildUrl` string, required: The URL to the build in the CI system
      - `buildStartedAt` string, date-time, required: The start date and time of the build
      - `buildFinishedAt` string, date-time: The end date and time of the build
      - `buildStatus` 'inProgress' | 'stopped' | 'success' | 'failure' | 'skipped', required: The status of the CI build. When passing build info as part of an artifact upload, this value should always be `success`.
      - `providerBuildStatusString` string: The status string displayed to the user from the provider
      - `commit` string, required: The commit hash that triggered the build
      - `commitMessage` string: The commit message associated with the commit hash that triggered the build
      - `commitAuthor` string: The author of the commit that triggered the build
      - `commitUrl` string: The URL to the commit in the version control system
      - `workflowName` string: The displayable name of the workflow
      - `branchName` string, required: The branch name the build was triggered from
      - `workflowRunIdOrCommaDelimitedIds` string: The workflow run ID(s) associated with this build. Can be a single ID or comma-delimited list of IDs
    - `binaryBuildNumber` string: The build number found associated to the binary artifact
    - `binaryBuildVersion` string: The build version found associated to the binary artifact
    - `binaryBuildType` string: The type of binary artifact
    - `additionalArtifacts` BuildDistroAdditionalArtifact[], required: Additional artifacts for the build
      - `fileName` string, required: The name of the file
      - `size` number, required: The file's size in bytes
      - `downloadUrl` string, required: The file's download URL. Requests to this URL must be authenticated with a Runway API key.

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.dev/runway/apis/runway-rest-api.md) - [All operations](https://skmtc.dev/runway/apis/runway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runway/apis/runway-rest-api/revisions/081109863a9a?raw)