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

# Game Center activities

Manage Game Center activities for your apps.

## Discussion

Use the activities API to create and configure ways to link players directly to your content in your game. Once you create an activity you can link it to a challenge and a leaderboard. To learn more about challenges, see [Configuring Game Center challenges](/documentation/AppStoreConnectAPI/configuring-game-center-challenges).

Activities provide a way to link players directly to your content. By describing your gameplay with activities, you can link the player to that part of your game when they engage with the activity. For example, when a player wants to complete your daily puzzle, you can send the player directly to that part of your game. To learn more about deep links and integrating activites in your game, see [Creating activities for your game] (https://developer.apple.com/documentation/gamekit/creating-activities-for-your-game).

To manage activities, be sure you have one of the following user roles:

- `ADMIN`
- `APP MANAGER`
- `MARKETING`

## Topics

### Managing Game Center activities

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

Create an activity for your Game Center detail or Game Center group.

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

Add an achievement to a Game Center activity.

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

Add a leaderboard to a Game Center activity.

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

Update the relationship between achievements and a specific Game Center activity.

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

Update the relationship between a leaderboard and a specific Game Center activity.

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

Get information for a specific Game Center activity.

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

Get a list of versions for a specific Game Center activity.

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

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

Get activity release information for a specific Game Center detail.

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

[`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.

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

Update details for a specific Game Center activity.

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

Remove a specific Game Center activity.

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

Remove an achievement from a Game Center activity.

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

Remove a leaderboard from a Game Center activity.

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

Remove the relationship between an achievement and a Game Center activity.

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

Remove the relationship between a leaderboard and a Game Center activity.

### Objects

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

A response containing a list of Game Center activities configured for an app.

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

A social or competitive event in Game Center that players can participate in, such as a leaderboard challenge.

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

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

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

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

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

The request body for updating the list of achievements linked to a Game Center activity.

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

The request body for updating the list of leaderboards linked to a Game Center activity.

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

The request body for creating a new Game Center activity.

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

The data structure you use to configure an activity version while creating an activity.

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

A response containing a single Game Center activity with its configuration.

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

The request body you use to update an activity.

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

A versioned configuration of a Game Center activity, containing its localizations and release status.

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

The request body for creating a version of a Game Center activity.

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

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

A dictionary object mapping arbitrary string keys to string values, used for flexible key-value metadata.



---

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)