Skip to main content

Create a tester group

POST 
/tester-groups

Creates a tester group for the app. Without a type (or with type=internal) an internal group of Bitrise users is created. With type=external an external group of email-only testers is created: provide a non-empty emails array (at most 1000 addresses, each at most 255 characters, syntactically validated) and a tester is created for every address and added to the group. The emails field is ignored for internal groups. For example, create an external group with ?type=external and body { "app_id": "<uuid>", "name": "My external testers", "emails": ["[email protected]", "[email protected]"] }. Members are added so that the group is created even when some of them cannot be: the response then carries an errors array of {code, message, details}, where details.group is the group and details.tester the slug or email that was sent. An internal member gets code ERR_INTERNAL_TESTER_NOT_ADDED, with details.reason ERR_USER_NOT_FOUND, ERR_NOT_WORKSPACE_OR_PROJECT_MEMBER or ERR_INTERNAL. An external address that is not valid gets code ERR_EXTERNAL_TESTER_NOT_ADDED, with details.reason ERR_INVALID_EMAIL; the valid addresses are still added, and only when none of them are valid is the request rejected with 400, listing them in details.invalid_emails. Note this is deliberately a different shape from the slug-keyed errors hash returned by add-testers.

RequestClick to copy link​

ResponsesClick to copy link​

The created tester group, with any members that could not be added

See also