Skip to main content

outlook calendargroup add

Creates a new calendar group for a user.

Usage​

m365 outlook calendargroup add [options]

Options​

--userId [userId]

ID of the user. Specify either userId or userName, but not both.

--userName [userName]

UPN of the user. Specify either userId or userName, but not both.

--name <name>

Name of the calendar group.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, permissions, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Permissions​

ResourcePermissions
Microsoft GraphCalendars.ReadWrite, Calendars.ReadWrite.Shared
note

When using delegated permissions, specifying userId or userName for a different user requires the Calendars.ReadWrite.Shared scope. When the specified user matches the signed-in user, no shared scope is needed.

Examples​

Create a new calendar group for the current user

m365 outlook calendargroup add --name "Personal Events" --userId "@meId"

Create a new calendar group for a user

m365 outlook calendargroup add --name "Personal Events" --userId "44288f7d-7710-4293-8c8e-36f310ed2e6a"

Create a new calendar group for a user specified by email

m365 outlook calendargroup add --name "Personal Events" --userName "john.doe@contoso.com"

Response​

{
  "id": "AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YWMyLTJhZGY2MGExMGU0MgBGAAADSG3wPE27kUeySjmT5eRT8QcAfJKVL07sbkmIfHqjbDnRgQAAAgEGAAAAfJKVL07sbkmIfHqjbDnRgQADK5c4ngAAAA==",
  "name": "My Work Calendars",
  "classId": "c02d4ddf-4809-485f-9cd4-1ef0937e03be",
  "changeKey": "fJKVL07sbkmIfHqjbDnRgQADKqwfAA=="
}