---
title: "POST /games/v1configuration/applications/{applicationId}/leaderboards"
method: POST
path: "/games/v1configuration/applications/{applicationId}/leaderboards"
tags: ["leaderboardConfigurations"]
---

# POST /games/v1configuration/applications/{applicationId}/leaderboards

`POST /games/v1configuration/applications/{applicationId}/leaderboards`

Insert a new leaderboard configuration in this application.

## Path parameters

- `applicationId` string, required

## Request body

- LeaderboardConfiguration — An leaderboard configuration resource.
  - `scoreOrder` 'SCORE_ORDER_UNSPECIFIED' | 'LARGER_IS_BETTER' | 'SMALLER_IS_BETTER'
  - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#leaderboardConfiguration`.
  - `draft` LeaderboardConfigurationDetail — A leaderboard configuration detail.
    - `sortRank` integer — The sort rank of this leaderboard. Writes to this field are ignored.
    - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#leaderboardConfigurationDetail`.
    - `scoreFormat` GamesNumberFormatConfiguration — A number format resource.
      - `numberFormatType` 'NUMBER_FORMAT_TYPE_UNSPECIFIED' | 'NUMERIC' | 'TIME_DURATION' | 'CURRENCY' — The formatting for the number.
      - `currencyCode` string — The curreny code string. Only used for CURRENCY format type.
      - `suffix` GamesNumberAffixConfiguration — A number affix resource.
        - `two` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `few` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `many` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `zero` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `other` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `one` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
      - `numDecimalPlaces` integer — The number of decimal places for number. Only used for NUMERIC format type.
    - `name` LocalizedStringBundle — A localized string bundle resource.
      - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
      - `translations` LocalizedString[] — The locale strings.
        - `value` string — The string value.
        - `locale` string — The locale string.
        - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
    - `iconUrl` string — The icon url of this leaderboard. Writes to this field are ignored.
  - `published` LeaderboardConfigurationDetail — A leaderboard configuration detail.
    - `sortRank` integer — The sort rank of this leaderboard. Writes to this field are ignored.
    - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#leaderboardConfigurationDetail`.
    - `scoreFormat` GamesNumberFormatConfiguration — A number format resource.
      - `numberFormatType` 'NUMBER_FORMAT_TYPE_UNSPECIFIED' | 'NUMERIC' | 'TIME_DURATION' | 'CURRENCY' — The formatting for the number.
      - `currencyCode` string — The curreny code string. Only used for CURRENCY format type.
      - `suffix` GamesNumberAffixConfiguration — A number affix resource.
        - `two` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `few` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `many` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `zero` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `other` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `one` LocalizedStringBundle — A localized string bundle resource.
          - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[] — The locale strings.
            - `value` string — The string value.
            - `locale` string — The locale string.
            - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
      - `numDecimalPlaces` integer — The number of decimal places for number. Only used for NUMERIC format type.
    - `name` LocalizedStringBundle — A localized string bundle resource.
      - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
      - `translations` LocalizedString[] — The locale strings.
        - `value` string — The string value.
        - `locale` string — The locale string.
        - `kind` string — Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
    - `iconUrl` string — The icon url of this leaderboard. Writes to this field are ignored.
  - `token` string — The token for this resource.
  - `scoreMax` string, int64 — Maximum score that can be posted to this leaderboard.
  - `id` string — The ID of the leaderboard.
  - `scoreMin` string, int64 — Minimum score that can be posted to this leaderboard.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/gamesconfiguration.md) · [All operations](https://skmtc.net/google/apis/gamesconfiguration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/gamesconfiguration/revisions/4b466b00bf86/schema)
