# Beta Groups Groups of beta testers that have access to one or more builds. ## Discussion A `betaGroups` resource represents the group of testers that have access to builds for testing. Each beta group is associated with a single app and contains one or more builds. Every tester has access to every build in the group. There are two types of beta tester groups: - Internal beta tester — Contains members of your App Store Connect team whom you’ve designated as beta testers. For more information about internal testers, see[Add internal testers](https://developer.apple.com/help/app-store-connect/test-a-beta-version/add-internal-testers). - External beta tester — You create and manage these groups. They may contain individuals from your company who don’t qualify as internal testers, or people outside of your organization that you’ve invited to test your app. For more information about external testers, see [Invite external testers](https://developer.apple.com/help/app-store-connect/test-a-beta-version/invite-external-testers). Add beta testers to a group through App Store Connect or with this API. ## Topics ### Creating, Modifying, and Deleting Beta Groups [`Create a beta group`](/documentation/AppStoreConnectAPI/POST-v1-betaGroups) Create a beta group associated with an app, optionally enabling TestFlight public links. [`Modify a beta group`](/documentation/AppStoreConnectAPI/PATCH-v1-betaGroups-_id_) Modify a beta group’s metadata, including changing its TestFlight public link status. [`Delete a beta group`](/documentation/AppStoreConnectAPI/DELETE-v1-betaGroups-_id_) Delete a beta group and remove beta tester access to associated builds. ### Getting Beta Group Information [`List beta groups`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups) Find and list beta groups for all apps. [`Read beta group information`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_) Get a specific beta group. [`Read the app information of a beta group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-app) Get the app information for a specific beta group. [`Get the app ID for a beta group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-relationships-app) [`Read Metrics for Beta Testers in a Beta Group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-metrics-betaTesterUsages) Get beta tester usage metrics for a beta group. [`Read Recruitment Criteria for a Beta Group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-betaRecruitmentCriteria) Get the recruitment criteria information for a specific beta group. [`List beta recruitment criterion IDs for a beta group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-relationships-betaRecruitmentCriteria) [`Read build compatibility for a beta group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-betaRecruitmentCriterionCompatibleBuildCheck) Get the build compatibility information for a specific beta group. [`Get the compatible build check ID for a beta group recruitment criterion`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-relationships-betaRecruitmentCriterionCompatibleBuildCheck) ### Adding and Removing Builds and Testers [`Add beta testers to a beta group`](/documentation/AppStoreConnectAPI/POST-v1-betaGroups-_id_-relationships-betaTesters) Add a specific beta tester to one or more beta groups for beta testing. [`Remove beta testers from a beta group`](/documentation/AppStoreConnectAPI/DELETE-v1-betaGroups-_id_-relationships-betaTesters) Remove a specific beta tester from a one or more beta groups, revoking their access to test builds associated with those groups. [`Add builds to a beta group`](/documentation/AppStoreConnectAPI/POST-v1-betaGroups-_id_-relationships-builds) Associate builds with a beta group to enable the group to test the builds. [`Remove builds from a beta group`](/documentation/AppStoreConnectAPI/DELETE-v1-betaGroups-_id_-relationships-builds) Remove access to test one or more builds from beta testers in a specific beta group. ### Reading Build and Beta Tester Information [`List all builds for a beta group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-builds) Get a list of builds associated with a specific beta group. [`Get all build ids in a beta group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-relationships-builds) Get a list of build resource IDs in a specific beta group. [`List all beta testers in a beta group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-betaTesters) Get a list of beta testers contained in a specific beta group. [`Get all beta tester ids in a beta group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-relationships-betaTesters) Get a list of the beta tester resource IDs in a specific beta group. ### Measuring public link usage [`Read Public Link Usage Metrics for a Beta Group`](/documentation/AppStoreConnectAPI/GET-v1-betaGroups-_id_-metrics-publicLinkUsages) Get public link usage metrics for a specific beta group. ### Objects [`BetaGroup`](/documentation/AppStoreConnectAPI/BetaGroup) A group of beta testers and builds that you use to manage TestFlight distribution for an app. [`BetaGroupResponse`](/documentation/AppStoreConnectAPI/BetaGroupResponse) The response body for endpoints that create, read, or modify a TestFlight beta group. [`BetaGroupsWithoutIncludesResponse`](/documentation/AppStoreConnectAPI/BetaGroupsWithoutIncludesResponse) A response body that contains a list of beta groups without any includes. [`BetaGroupCreateRequest`](/documentation/AppStoreConnectAPI/BetaGroupCreateRequest) The request body you use to create a Beta Group. [`BetaGroupUpdateRequest`](/documentation/AppStoreConnectAPI/BetaGroupUpdateRequest) The request body you use to update a Beta Group. [`BetaGroupBuildsLinkagesRequest`](/documentation/AppStoreConnectAPI/BetaGroupBuildsLinkagesRequest) A request body you use to add or remove builds from a beta group. [`BetaGroupBetaTestersLinkagesRequest`](/documentation/AppStoreConnectAPI/BetaGroupBetaTestersLinkagesRequest) A request body you use to add or remove beta testers from a beta group. [`BetaGroupBetaTestersLinkagesResponse`](/documentation/AppStoreConnectAPI/BetaGroupBetaTestersLinkagesResponse) A response body that contains a list of related resource IDs. [`BetaGroupBuildsLinkagesResponse`](/documentation/AppStoreConnectAPI/BetaGroupBuildsLinkagesResponse) A response body that contains a list of related resource IDs. [`BetaPublicLinkUsagesV1MetricResponse`](/documentation/AppStoreConnectAPI/BetaPublicLinkUsagesV1MetricResponse) A metrics response containing usage data for a TestFlight public invite link, showing tester enrollment trends. [`BetaGroupsResponse`](/documentation/AppStoreConnectAPI/BetaGroupsResponse) The response body for endpoints that list TestFlight beta groups. [`BetaGroupAppLinkageResponse`](/documentation/AppStoreConnectAPI/BetaGroupAppLinkageResponse) [`BetaGroupBetaRecruitmentCriteriaLinkageResponse`](/documentation/AppStoreConnectAPI/BetaGroupBetaRecruitmentCriteriaLinkageResponse) [`BetaGroupBetaRecruitmentCriterionCompatibleBuildCheckLinkageResponse`](/documentation/AppStoreConnectAPI/BetaGroupBetaRecruitmentCriterionCompatibleBuildCheckLinkageResponse) --- Copyright © 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)