Headers:

• Authorization: nadeo_v1 t={token} An access token for the NadeoLiveServices audience

Body parameters:

• {name} string The name of the new club *
  Minimum: 3 characters Maximum: 20 characters
• {state} string The privacy level of the club (see remarks below) *
• {tag} string The club tag for players to use in-game
  Maximum: 5 characters
• {description} string A description of the club
  Maximum: 200 characters
• {iconTheme} string The name of the theme preset for the icon displayed in the list of clubs in-game, in lower case
• {decalTheme} string The name of the theme preset for the image displayed at the start, checkpoints, and finishes, in lower case
• {verticalTheme} string The name of the theme preset for the vertical image displayed in My Clubs list, in lower case
• {backgroundTheme} string The name of the theme preset for the background displayed in the club details page, in lower case
• {screen8x1Theme} string The name of the theme preset for the image displayed on the stadium's bleachers, in lower case
• {screen16x1Theme} string The name of the theme preset for the image displayed on the stadium's banners below the big screen, in lower case
• {screen16x9Theme} string The name of the theme preset for the image displayed on the stadium's big screen, in lower case

The request body is an object containing the club details:

{
  "name": name,
  "state": state,
  "tag": tag,
  "description": description,
  "iconTheme": iconTheme,
  "decalTheme": decalTheme,
  "verticalTheme": verticalTheme,
  "backgroundTheme": backgroundTheme,
  "screen8x1Theme": screen8x1Theme,
  "screen16x1Theme": screen16x1Theme,
  "screen16x9Theme": screen16x9Theme
}

Creates a new club.

Remarks:

• This endpoint is only useful with tokens authenticated through Ubisoft user accounts (as opposed to dedicated server accounts).
• See the glossary for a list of available privacy levels.
• A list of theme presets that can be used for the theme parameters can be found in the following directory when selecting an image for a club activity: Manialinks\Nadeo\CMGame\OfficialThemes.
• The tag field supports text styling, which does not count towards the maximum character length. See the Text Styling documentation for more information about the supported styles and syntax.
• As of 2024-01-17, this endpoint's response links to .dds media files by default, while several scaled .png/.jpg versions are available using separate fields (see example below for reference). This only applies for custom media files, and not for preset themes.

Example request:

POST https://live-services.trackmania.nadeo.live/api/token/club/create

{
  "name": "Testing club",
  "state": "private-closed",
  "tag": "DOCS",
  "description": "This is a club for testing",
  "iconTheme": "racing",
  "decalTheme": "racing",
  "verticalTheme": "valhalla",
  "backgroundTheme": "valhalla",
  "screen8x1Theme": "mirage",
  "screen16x1Theme": "mirage",
  "screen16x9Theme": "mirage"
}

Example response:

{
  "creationTimestamp": 1771820094,
  "walletUid": "559cd73b-de9d-45df-82b6-b36ae04bd668",
  "id": 131063,
  "decalUrl": "",
  "decalSponsor4x1UrlPngLarge": "",
  "backgroundUrlJpgLarge": "",
  "decalSponsor4x1UrlDds": "",
  "decalTheme": "racing",
  "screen16x1Url": "",
  "name": "Testing club",
  "screen64x41Theme": "mirage",
  "screen64x41UrlDds": "",
  "featured": false,
  "decalUrlPngMedium": "",
  "screen64x41UrlPngLarge": "",
  "screen16x1UrlDds": "",
  "verified": false,
  "screen16x9Theme": "mirage",
  "latestEditorAccountId": "69f31664-4252-48e0-a433-024c49caee8c",
  "iconUrlPngMedium": "",
  "backgroundUrlDds": "",
  "editionTimestamp": 1771820094,
  "backgroundUrlJpgSmall": "",
  "tag": "DOCS",
  "backgroundUrlJpgMedium": "",
  "verticalUrlPngMedium": "",
  "metadata": "",
  "decalUrlPngSmall": "",
  "verticalTheme": "valhalla",
  "backgroundTheme": "valhalla",
  "verticalUrlPngSmall": "",
  "iconUrlPngSmall": "",
  "iconUrl": "",
  "popularityLevel": 0,
  "screen8x1UrlDds": "",
  "verticalUrlPngLarge": "",
  "screen16x9Url": "",
  "screen64x41UrlPngMedium": "",
  "screen16x1UrlPngMedium": "",
  "screen8x1UrlPngSmall": "",
  "authorAccountId": "69f31664-4252-48e0-a433-024c49caee8c",
  "screen16x1UrlPngLarge": "",
  "state": "private-closed",
  "screen16x9UrlDds": "",
  "verticalUrlDds": "",
  "logoUrl": "",
  "screen8x1UrlPngMedium": "",
  "screen16x9UrlPngLarge": "",
  "screen64x41Url": "",
  "screen16x9UrlPngSmall": "",
  "screen16x9UrlPngMedium": "",
  "description": "This is a club for testing",
  "decalSponsor4x1UrlPngSmall": "",
  "screen8x1Theme": "mirage",
  "screen8x1UrlPngLarge": "",
  "verticalUrl": "",
  "screen16x1Theme": "mirage",
  "iconTheme": "racing",
  "screen64x41UrlPngSmall": "",
  "decalUrlPngLarge": "",
  "iconUrlPngLarge": "",
  "decalUrlDds": "",
  "decalSponsor4x1Url": "",
  "screen8x1Url": "",
  "iconUrlDds": "",
  "screen16x1UrlPngSmall": "",
  "decalSponsor4x1UrlPngMedium": "",
  "backgroundUrl": ""
}

If the state parameter is invalid, the response will contain an error:

[
  "state:error-inArray"
]