> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFLeaderboardsCreateLeaderboardDefinitionRequest

> Reference for the PFLeaderboardsCreateLeaderboardDefinitionRequest struct in the PlayFab Services C API, describing columns, name, and version settings.

PFLeaderboardsCreateLeaderboardDefinitionRequest data model.

## Syntax

```cpp theme={null}
typedef struct PFLeaderboardsCreateLeaderboardDefinitionRequest {  
    PFLeaderboardsLeaderboardColumn const* columns;  
    uint32_t columnsCount;  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    const char* entityType;  
    PFLeaderboardsLeaderboardEventEmissionConfig const* eventEmissionConfig;  
    const char* name;  
    int32_t sizeLimit;  
    PFVersionConfiguration const* versionConfiguration;  
} PFLeaderboardsCreateLeaderboardDefinitionRequest;  
```

### Members

**`columns`**   [PFLeaderboardsLeaderboardColumn](/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsleaderboardcolumn) const\*

Leaderboard columns describing the sort directions, cannot be changed after creation. A maximum of 5 columns are allowed.

**`columnsCount`**   uint32\_t

Count of columns

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

(Optional) The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

**`customTagsCount`**   uint32\_t

Count of customTags

**`entityType`**   const char\*<br />*is null-terminated*

The entity type being represented on the leaderboard. If it doesn't correspond to the PlayFab entity types, use 'external' as the type.

**`eventEmissionConfig`**   [PFLeaderboardsLeaderboardEventEmissionConfig](/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsleaderboardeventemissionconfig) const\*<br />*may be nullptr*

(Optional) \[In Preview]: The configuration for the events emitted by this leaderboard. If not specified, no events will be emitted.

**`name`**   const char\*<br />*is null-terminated*

A name for the leaderboard, unique per title.

**`sizeLimit`**   int32\_t

Maximum number of entries on this leaderboard.

**`versionConfiguration`**   PFVersionConfiguration const\*<br />*may be nullptr*

(Optional) The version reset configuration for the leaderboard definition.

## Requirements

**Header:** PFLeaderboardsTypes.h

## See also

[PFLeaderboardsTypes members](/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members)


## Related topics

- [PFLeaderboardsCreateLeaderboardDefinitionAsync](/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardscreateleaderboarddefinitionasync.md)
- [Services C API overview - PFLeaderboardsTypes.h](/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)
- [PFLeaderboardsDeleteLeaderboardDefinitionRequest](/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsdeleteleaderboarddefinitionrequest.md)
- [PFLeaderboardsGetLeaderboardDefinitionRequest](/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetleaderboarddefinitionrequest.md)
- [PFLeaderboardsUpdateLeaderboardDefinitionRequest](/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsupdateleaderboarddefinitionrequest.md)