---
title: "Creates a matchmaking scoring configuration."
method: POST
path: "/matchmaking-api/v1/matchmaking/scoring-configuration"
tags: ["Matchmaking"]
---

# Creates a matchmaking scoring configuration.

`POST /matchmaking-api/v1/matchmaking/scoring-configuration`

## Request body

- CreateMatchmakingScoringConfigurationRequest — Request to create a matchmaking scoring configuration.
  - `universeId` integer — UniverseId for the new matchmaking scoring configuraiton.
  - `name` string, nullable — Name of the scoring configuration.
  - `matchmakingSignalWeights` object, nullable — The desired set of weights for each matchmaking signal.
    - `Invalid` number, double
    - `Occupancy` number, double
    - `Age` number, double
    - `Language` number, double
    - `Latency` number, double
    - `PreferredPlayers` number, double
    - `VoiceChat` number, double
    - `DeviceType` number, double
    - `PlayHistory` number, double
    - `TextChat` number, double
  - `customSignalWeights` object, nullable — The desired set of weights for custom signals. It is a map from custom signal name to its weight.
  - `template` 'NotApplicable' | 'UseDefault' — A predefined template used for creating matchmaking scoring configuration.

## Response `200`

Success

- CreateMatchmakingScoringConfigurationResponse — Response to create a matchmaking scoring configuration.
  - `scoringConfiguration` MatchmakingScoringConfiguration — The custom scoring configuration for matchmaking.
    - `id` string, nullable — The id of the scoring configuration.
    - `name` string, nullable — The name of the scoring configuration. It needs to be unique within a universe.
    - `signalWeights` object, nullable — The signal weights for the scoring configuration.
      - `Invalid` MatchmakingSignalWeightConfiguration — The signal weight configuration for matchmaking.
        - `weight` number, double — Weight of signal.
        - `signalType` 'Invalid' | 'Occupancy' | 'Age' | 'Language' | 'Latency' | 'PreferredPlayers' | 'VoiceChat' | 'DeviceType' | 'PlayHistory' | 'TextChat' — The default signal types matchmaking uses.
      - `Occupancy` MatchmakingSignalWeightConfiguration — The signal weight configuration for matchmaking.
        - `weight` number, double — Weight of signal.
        - `signalType` 'Invalid' | 'Occupancy' | 'Age' | 'Language' | 'Latency' | 'PreferredPlayers' | 'VoiceChat' | 'DeviceType' | 'PlayHistory' | 'TextChat' — The default signal types matchmaking uses.
      - `Age` MatchmakingSignalWeightConfiguration — The signal weight configuration for matchmaking.
        - `weight` number, double — Weight of signal.
        - `signalType` 'Invalid' | 'Occupancy' | 'Age' | 'Language' | 'Latency' | 'PreferredPlayers' | 'VoiceChat' | 'DeviceType' | 'PlayHistory' | 'TextChat' — The default signal types matchmaking uses.
      - `Language` MatchmakingSignalWeightConfiguration — The signal weight configuration for matchmaking.
        - `weight` number, double — Weight of signal.
        - `signalType` 'Invalid' | 'Occupancy' | 'Age' | 'Language' | 'Latency' | 'PreferredPlayers' | 'VoiceChat' | 'DeviceType' | 'PlayHistory' | 'TextChat' — The default signal types matchmaking uses.
      - `Latency` MatchmakingSignalWeightConfiguration — The signal weight configuration for matchmaking.
        - `weight` number, double — Weight of signal.
        - `signalType` 'Invalid' | 'Occupancy' | 'Age' | 'Language' | 'Latency' | 'PreferredPlayers' | 'VoiceChat' | 'DeviceType' | 'PlayHistory' | 'TextChat' — The default signal types matchmaking uses.
      - `PreferredPlayers` MatchmakingSignalWeightConfiguration — The signal weight configuration for matchmaking.
        - `weight` number, double — Weight of signal.
        - `signalType` 'Invalid' | 'Occupancy' | 'Age' | 'Language' | 'Latency' | 'PreferredPlayers' | 'VoiceChat' | 'DeviceType' | 'PlayHistory' | 'TextChat' — The default signal types matchmaking uses.
      - `VoiceChat` MatchmakingSignalWeightConfiguration — The signal weight configuration for matchmaking.
        - `weight` number, double — Weight of signal.
        - `signalType` 'Invalid' | 'Occupancy' | 'Age' | 'Language' | 'Latency' | 'PreferredPlayers' | 'VoiceChat' | 'DeviceType' | 'PlayHistory' | 'TextChat' — The default signal types matchmaking uses.
      - `DeviceType` MatchmakingSignalWeightConfiguration — The signal weight configuration for matchmaking.
        - `weight` number, double — Weight of signal.
        - `signalType` 'Invalid' | 'Occupancy' | 'Age' | 'Language' | 'Latency' | 'PreferredPlayers' | 'VoiceChat' | 'DeviceType' | 'PlayHistory' | 'TextChat' — The default signal types matchmaking uses.
      - `PlayHistory` MatchmakingSignalWeightConfiguration — The signal weight configuration for matchmaking.
        - `weight` number, double — Weight of signal.
        - `signalType` 'Invalid' | 'Occupancy' | 'Age' | 'Language' | 'Latency' | 'PreferredPlayers' | 'VoiceChat' | 'DeviceType' | 'PlayHistory' | 'TextChat' — The default signal types matchmaking uses.
      - `TextChat` MatchmakingSignalWeightConfiguration — The signal weight configuration for matchmaking.
        - `weight` number, double — Weight of signal.
        - `signalType` 'Invalid' | 'Occupancy' | 'Age' | 'Language' | 'Latency' | 'PreferredPlayers' | 'VoiceChat' | 'DeviceType' | 'PlayHistory' | 'TextChat' — The default signal types matchmaking uses.
    - `customSignals` object, nullable — The custom signals part of this place's scoring configuration.
    - `createdTime` string, date-time — The scoring configuration's created time.
    - `updatedTime` string, date-time — The scoring configuration's updated time.

---

[API](https://skmtc.net/roblox/apis/roblox-api.md) · [All operations](https://skmtc.net/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roblox/roblox-api/versions/e15802062270/schema)