> ## 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.

# PFGroupsAddMembersRequest

> PFGroupsAddMembersRequest data model. Adds members to a group or role. Existing members of the group will added to roles within the group, but if the user is.

PFGroupsAddMembersRequest data model. Adds members to a group or role. Existing members of the group will added to roles within the group, but if the user is not already a member of the group, only title claimants may add them to the group, and others must use the group application or invite system to add new members to a group. Returns nothing if successful.

## Syntax

```cpp theme={null}
typedef struct PFGroupsAddMembersRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* group;  
    PFEntityKey const* members;  
    uint32_t membersCount;  
    const char* roleId;  
} PFGroupsAddMembersRequest;  
```

### Members

**`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

**`group`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

The identifier of the group.

**`members`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

List of entities to add to the group. Only entities of type title\_player\_account and character may be added to groups.

**`membersCount`**   uint32\_t

Count of members

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

(Optional) Optional: The ID of the existing role to add the entities to. If this is not specified, the default member role for the group will be used. Role IDs must be between 1 and 64 characters long.

## Requirements

**Header:** PFGroupsTypes.h

## See also

[PFGroupsTypes members](/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members)


## Related topics

- [PFGroupsAddMembersAsync](/services/playfab/api-references/c/pfgroups/functions/pfgroupsaddmembersasync.md)
- [Services C API overview - PFGroupsTypes.h](/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [PFGroupsIsMemberRequest](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsismemberrequest.md)
- [PFGroupsListGroupMembersRequest](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupmembersrequest.md)
- [PFGroupsRemoveMembersRequest](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsremovemembersrequest.md)