File: //lib/python3/dist-packages/awscli/examples/cognito-idp/create-group.rst
**To create a group**
This example creates a group with a description.
Command::
aws cognito-idp create-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyNewGroup --description "New group."
Output::
{
"Group": {
"GroupName": "MyNewGroup",
"UserPoolId": "us-west-2_aaaaaaaaa",
"Description": "New group.",
"LastModifiedDate": 1548270073.795,
"CreationDate": 1548270073.795
}
}
**To create a group with a role and precedence**
This example creates a group with a description. It also includes a role and precedence.
Command::
aws cognito-idp create-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyNewGroupWithRole --description "New group with a role." --role-arn arn:aws:iam::111111111111:role/MyNewGroupRole --precedence 2
Output::
{
"Group": {
"GroupName": "MyNewGroupWithRole",
"UserPoolId": "us-west-2_aaaaaaaaa",
"Description": "New group with a role.",
"RoleArn": "arn:aws:iam::111111111111:role/MyNewGroupRole",
"Precedence": 2,
"LastModifiedDate": 1548270211.761,
"CreationDate": 1548270211.761
}
}