<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/game-center-groups",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Game Center groups"
}
-->

# Game Center groups

Manage groups between your apps.

## Discussion

Use groups to connect multiple apps so they use common Game Center elements including: achievements, Game Center details, leaderboards, and leaderboard sets.

Use this resource to:

- Create and modify Game Center groups.
- Read and modify relationships between a Game Center group and achievements, Game Center details, leaderboards, and leaderboard sets.

## Topics

### Managing groups

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

List information for all groups.

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

Read information for a specific Game Center group.

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

Add a new group.

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

Edit the reference name for a group.

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

Remove a group.

[`GET /v1/gameCenterGroups/{id}/gameCenterAchievementsV2`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-gameCenterAchievementsV2)

Get a list of achievements for a specific Game Center group.

[`GET /v1/gameCenterGroups/{id}/gameCenterLeaderboardSetsV2`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-gameCenterLeaderboardSetsV2)

Get a list of leaderboard sets for a specific Game Center group.

[`GET /v1/gameCenterGroups/{id}/gameCenterLeaderboardsV2`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-gameCenterLeaderboardsV2)

Get a list of leaderboards for a specific Game Center group.

[`GET /v1/gameCenterGroups/{id}/gameCenterAchievements`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-gameCenterAchievements)

List achievements information for a specific group.

[`GET /v1/gameCenterGroups/{id}/gameCenterDetails`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-gameCenterDetails)

Read Game Center detail information for a specific group.

[`GET /v1/gameCenterGroups/{id}/relationships/gameCenterDetails`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-relationships-gameCenterDetails)

[`GET /v1/gameCenterGroups/{id}/relationships/gameCenterDetails`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-relationships-gameCenterDetails)

[`GET /v1/gameCenterGroups/{id}/gameCenterLeaderboardSets`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-gameCenterLeaderboardSets)

Read Game Center leaderboard sets information for a specific group.

[`GET /v1/gameCenterGroups/{id}/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-gameCenterLeaderboards)

Read Game Center leaderboard information for a specific group.

[`GET /v1/gameCenterGroups/{id}/gameCenterActivities`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-gameCenterActivities)

Get a list of all activities for a Game Center group.

[`GET /v1/gameCenterGroups/{id}/relationships/gameCenterActivities`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-relationships-gameCenterActivities)

Get a list of activity IDs for a specific Game Center group.

[`GET /v1/gameCenterGroups/{id}/gameCenterChallenges`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-gameCenterChallenges)

Get challenge information for a specific Game Center group.

[`GET /v1/gameCenterGroups/{id}/relationships/gameCenterChallenges`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-relationships-gameCenterChallenges)

### Reading and modifying group relationships

[`GET /v1/gameCenterGroups/{id}/relationships/gameCenterAchievementsV2`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-relationships-gameCenterAchievementsV2)

Get a list of achievement resource IDs for a specific Game Center group.

[`GET /v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardSetsV2`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-relationships-gameCenterLeaderboardSetsV2)

Get a list of leaderboard set resource IDs for a specific Game Center group.

[`GET /v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardsV2`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-relationships-gameCenterLeaderboardsV2)

Get a list of leaderboard resource IDs for a specific Game Center group.

[`PATCH /v1/gameCenterGroups/{id}/relationships/gameCenterAchievementsV2`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterGroups-_id_-relationships-gameCenterAchievementsV2)

Update the achievements relationship for a specific Game Center group.

[`PATCH /v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardSetsV2`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterGroups-_id_-relationships-gameCenterLeaderboardSetsV2)

Update the leaderboard sets relationship for a specific Game Center group.

[`PATCH /v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardsV2`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterGroups-_id_-relationships-gameCenterLeaderboardsV2)

Update the leaderboards relationship for a specific Game Center group.

[`GET /v1/gameCenterGroups/{id}/relationships/gameCenterAchievements`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-relationships-gameCenterAchievements)

List all the achievements associated with a specific group.

[`GET /v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardSets`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-relationships-gameCenterLeaderboardSets)

List all the leaderboard sets associated with a specific group.

[`GET /v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterGroups-_id_-relationships-gameCenterLeaderboards)

List all the leaderboard associated with a specific group.

[`PATCH /v1/gameCenterGroups/{id}/relationships/gameCenterAchievements`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterGroups-_id_-relationships-gameCenterAchievements)

Modify the achievements in a specific group.

[`PATCH /v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardSets`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterGroups-_id_-relationships-gameCenterLeaderboardSets)

Modify the leaderboard sets in a specific group.

[`PATCH /v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterGroups-_id_-relationships-gameCenterLeaderboards)

Modify the Game Center leaderboards in a specific group.

### Objects

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

A named group that shares leaderboards and achievements across multiple apps in Game Center.

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

The request body you use to create a group.

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

The data structure that represents a Game Center group Game Center achievement linkage request resource.

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

A response that contains a list of Game Center group Game Center achievement linkage resources.

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

The data structure that represents a Game Center group Game Center leaderboard set linkage request resource.

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

A response that contains a list of Game Center group Game Center leaderboard set linkage resources.

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

The data structure that represents a Game Center group Game Center leaderboard linkage request resource.

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

A response that contains a list of Game Center group Game Center leaderboard linkage resources.

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

The request body you use to create a relationship between a group and an achievement.

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

A response that confirms a relationship between a group and an achievement.

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

The request body you use to create a relationship between a group and a leaderboard set.

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

A response that confirms a relationship between a group and leaderboard set.

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

The request body you use to create a relationship between a group and a leaderboard.

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

A response that confirms a relationship between a group and a leaderboard.

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

A response containing a single Game Center group that shares leaderboards and achievements across apps.

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

The request body you use to update a group.

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

A response that contains one or more groups.

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

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

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



---

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)