<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/beta-recruitment-criteria",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Beta recruitment criteria"
}
-->

# Beta recruitment criteria

Create public links that accept testers with specific device and OS combinations.

## Discussion

Use the `betaRecruitmentCriteria` resource to create public links with Device and OS criteria that help improve beta recruitment. Gain insights on the public-link performance from tester-event metrics, so you can modify the criteria set for the public, and enable or disable a public link.

Team keys or individual keys with these roles can use this this resource:

- Account holder
- Admin
- App Managers

## Topics

### Resending Invitations

[`POST /v1/betaRecruitmentCriteria`](/documentation/AppStoreConnectAPI/POST-v1-betaRecruitmentCriteria)

Create new criteria for recruiting testers for your TestFlight build.

[`PATCH /v1/betaRecruitmentCriteria/{id}`](/documentation/AppStoreConnectAPI/PATCH-v1-betaRecruitmentCriteria-_id_)

Update the recruitment criteria for your TestFlight build.

[`DELETE /v1/betaRecruitmentCriteria/{id}`](/documentation/AppStoreConnectAPI/DELETE-v1-betaRecruitmentCriteria-_id_)

Remove the recruitment criteria for your TestFlight build.

[`GET /v1/betaGroups/{id}/betaRecruitmentCriteria`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-betaRecruitmentCriteria)

Get the recruitment criteria information for a specific beta group.

[`GET /v1/betaGroups/{id}/betaRecruitmentCriterionCompatibleBuildCheck`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-betaRecruitmentCriterionCompatibleBuildCheck)

Get the build compatibility information for a specific beta group.

[`GET /v1/betaRecruitmentCriterionOptions`](/documentation/AppStoreConnectAPI/GET-v1-betaRecruitmentCriterionOptions)

Get a list of the possible beta recruitment criteria options.

### Objects

[`BetaRecruitmentCriterionCompatibleBuildCheck`](/documentation/AppStoreConnectAPI/BetaRecruitmentCriterionCompatibleBuildCheck)

The result of checking whether a specific build meets the device family and OS version requirements of a beta recruitment criterion.

[`BetaRecruitmentCriterionCompatibleBuildCheckResponse`](/documentation/AppStoreConnectAPI/BetaRecruitmentCriterionCompatibleBuildCheckResponse)

A response containing a single result of checking whether a build meets the requirements of a beta recruitment criterion.

[`BetaRecruitmentCriterion`](/documentation/AppStoreConnectAPI/BetaRecruitmentCriterion)

A rule that controls which testers are automatically invited to a beta group based on device family and OS version.

[`BetaRecruitmentCriterionCreateRequest`](/documentation/AppStoreConnectAPI/BetaRecruitmentCriterionCreateRequest)

The request body you use to create a beta recruitment criterion.

[`BetaRecruitmentCriterionOption`](/documentation/AppStoreConnectAPI/BetaRecruitmentCriterionOption)

A specific device family and OS version combination available as a value for a beta recruitment criterion.

[`BetaRecruitmentCriterionResponse`](/documentation/AppStoreConnectAPI/BetaRecruitmentCriterionResponse)

A response containing a single beta recruitment criterion and its configured device/OS requirements.

[`BetaRecruitmentCriterionUpdateRequest`](/documentation/AppStoreConnectAPI/BetaRecruitmentCriterionUpdateRequest)

The request body for updating the device family and OS version requirements of a beta recruitment criterion.

[`BetaPublicLinkUsagesV1MetricResponse`](/documentation/AppStoreConnectAPI/BetaPublicLinkUsagesV1MetricResponse)

A metrics response containing usage data for a TestFlight public invite link, showing tester enrollment trends.

[`DeviceFamily`](/documentation/AppStoreConnectAPI/DeviceFamily)

String that represents a device family.

[`DeviceFamilyOsVersionFilter`](/documentation/AppStoreConnectAPI/DeviceFamilyOsVersionFilter)

The object that you use to specify a device family and operating system to use for your beta recruitment criteria.

[`BetaRecruitmentCriterionOptionsResponse`](/documentation/AppStoreConnectAPI/BetaRecruitmentCriterionOptionsResponse)

A response containing a list of device family and OS version options for configuring a beta recruitment criterion.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)