Headers:

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

Path parameters:

• {clubId} integer The ID of the club where the folder should be created *

Body parameters:

• {name} string The name of the new folder *
• {folderId} integer The ID of the parent folder

The request body is an object containing the name of the club folder and its parent folder's ID:

{
  "name": name,
  "folderId": folderId,
}

Creates a folder in a club.

Remarks:

• This endpoint is only useful with tokens authenticated through Ubisoft user accounts (as opposed to dedicated server accounts).
• 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.
• See the glossary for more information about folders.

Example request:

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

{
  "name": "My maps",
  "folderId": 0
}

Example response:

{
  "id": 1004355,
  "folderId": null,
  "public": true,
  "activityId": 1004355,
  "campaignId": 0,
  "name": "My maps",
  "clubId": 103034,
  "password": false,
  "featured": false,
  "activityType": "folder",
  "mediaUrlPngSmall": "",
  "mediaUrl": "",
  "latestEditorAccountId": "69f31664-4252-48e0-a433-024c49caee8c",
  "editionTimestamp": 1771658680,
  "mediaUrlPngLarge": "",
  "itemsCount": 0,
  "mediaTheme": "",
  "position": 0,
  "targetActivityId": 1004355,
  "externalId": 0,
  "creatorAccountId": "69f31664-4252-48e0-a433-024c49caee8c",
  "mediaUrlDds": "",
  "active": true,
  "mediaUrlPngMedium": ""
}

If the club does not exist, the response will contain an error:

[
  "activity:error-notFound"
]

If the player does not have enough permissions in the club to create folders, the response will contain an error:

[
  "clubMemberRole:error-notContentCreator"
]