---
title: "POST /v1/{+name}:distribute"
method: POST
path: "/v1/{+name}:distribute"
tags: ["projects"]
---

# POST /v1/{+name}:distribute

`POST /v1/{+name}:distribute`

Distributes a release to testers. This call does the following: 1. Creates testers for the specified emails, if none exist. 2. Adds the testers and groups to the release. 3. Sends new testers an invitation email. 4. Sends existing testers a new release email. The request will fail with a `INVALID_ARGUMENT` if it contains a group that doesn't exist.

## Path parameters

- `name` string, required

## Request body

- GoogleFirebaseAppdistroV1DistributeReleaseRequest — The request message for `DistributeRelease`.
  - `testerEmails` string[] — Optional. A list of tester email addresses to be given access to this release. A combined maximum of 999 `testerEmails` and `groupAliases` can be specified in a single request.
  - `groupAliases` string[] — Optional. A list of group aliases (IDs) to be given access to this release. A combined maximum of 999 `testerEmails` and `groupAliases` can be specified in a single request.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/firebaseappdistribution.md) · [All operations](https://skmtc.dev/google/apis/firebaseappdistribution/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/firebaseappdistribution/revisions/f76302533b5d/schema)