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

# PFGroupsCreateGroupRequest

> PFGroupsCreateGroupRequest data model. Creates a new group, as well as administration and member roles, based off of a title's group template.

PFGroupsCreateGroupRequest data model. Creates a new group, as well as administration and member roles, based off of a title's group template. Returns information about the group that was created.

## Syntax

```cpp theme={null}
typedef struct PFGroupsCreateGroupRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* entity;  
    const char* groupName;  
} PFGroupsCreateGroupRequest;  
```

### Members

**`customTags`**   [PFStringDictionaryEntry](https://docs.xbox.com/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*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

**`entity`**   [PFEntityKey](https://docs.xbox.com/services/playfab/api-references/c/pftypes/structs/pfentitykey-c.md) const\*\
*may be nullptr*

(Optional) The optional entity to perform this action on. Defaults to the currently logged in entity.

**`groupName`**   const char\*\
*is null-terminated*

The name of the group. This is unique at the title level by default.

## Requirements

**Header:** PFGroupsTypes.h

## See also

[PFGroupsTypes members](https://docs.xbox.com/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)


## Related topics

- [PFGroupsCreateGroupAsync](https://docs.xbox.com/services/playfab/api-references/c/pfgroups/functions/pfgroupscreategroupasync.md)
- [Services C API overview - PFGroupsTypes.h](https://docs.xbox.com/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [Create Group](https://docs.xbox.com/services/playfab/api-references/rest/groups/groups/create-group.md)
- [PFGroupsCreateGroupRoleRequest](https://docs.xbox.com/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprolerequest.md)
- [PFGroupsApplyToGroupRequest](https://docs.xbox.com/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsapplytogrouprequest.md)