category: IT Services provider: Microsoft sectionorder: - Connect commonfields: id: Microsoft Graph Calendar version: -1 configuration: - defaultvalue: https://graph.microsoft.com display: Server URL name: url required: true type: 0 section: Connect - display: ID (received from the admin consent - see Detailed Instructions (?) name: auth_id type: 4 hidden: true required: false section: Connect - displaypassword: ID (received from the admin consent - see Detailed Instructions (?) name: credentials_auth_id hiddenusername: true type: 9 required: false section: Connect - display: Token (received from the admin consent - see Detailed Instructions (?) section) name: tenant_id type: 4 hidden: true required: false section: Connect - displaypassword: Token (received from the admin consent - see Detailed Instructions (?) name: credentials_tenant_id hiddenusername: true type: 9 required: false section: Connect - display: Key (received from the admin consent - see Detailed Instructions (?) name: enc_key type: 4 hidden: true required: false section: Connect - displaypassword: Key (received from the admin consent - see Detailed Instructions (?) name: credentials_enc_key hiddenusername: true type: 9 required: false section: Connect - additionalinfo: Used for certificate authentication. As appears in the "Certificates & secrets" page of the app. display: Certificate Thumbprint name: certificate_thumbprint type: 4 hidden: true required: false section: Connect - additionalinfo: Used for certificate authentication. As appears in the "Certificates & secrets" page of the app. displaypassword: Certificate Thumbprint name: credentials_certificate_thumbprint hiddenusername: true type: 9 required: false section: Connect - additionalinfo: Used for certificate authentication. The private key of the registered certificate. display: Private Key name: private_key type: 14 required: false section: Connect - additionalinfo: Relevant only if the integration is running on Azure VM. If selected, authenticates based on the value provided for the Azure Managed Identities Client ID field. If no value is provided for the Azure Managed Identities Client ID field, authenticates based on the System Assigned Managed Identity. For additional information, see the Help tab. display: Use Azure Managed Identities name: use_managed_identities type: 8 required: false section: Connect - additionalinfo: The Managed Identities client ID for authentication - relevant only if the integration is running on Azure VM. displaypassword: Azure Managed Identities Client ID name: managed_identities_client_id hiddenusername: true type: 9 required: false section: Connect - display: Default user name: default_user type: 0 required: false section: Connect - display: Trust any certificate (not secure) name: insecure type: 8 required: false section: Connect - display: Use system proxy settings name: proxy type: 8 required: false section: Connect - additionalinfo: Select this checkbox if you are using a self-deployed Azure application. display: Use a self-deployed Azure Application name: self_deployed type: 8 required: false section: Connect description: O365 Outlook Calendar enables you to create and manage different calendars and events according to your requirements. display: O365 Outlook Calendar name: Microsoft Graph Calendar script: commands: - name: msgraph-calendar-list-calendars description: Retrieves a list of user Calendar. arguments: - name: user description: User ID or userPrincipalName. - name: order_by description: Sorts the order of the items returned from Microsoft Graph. - name: next_link description: The link for the next page of results, if it exists. See docs.microsoft.com/en-us/graph/api/event-list?view=graph-rest-1.0 for more details. - name: top description: Specifies the page size of the result set. outputs: - contextPath: MSGraphCalendar.Calendar.Name description: The calendar name. type: String - contextPath: MSGraphCalendar.Calendar.CanShare description: "Whether the user has the permission to share the calendar. Only the user who created the calendar can share." type: Boolean - contextPath: MSGraphCalendar.Calendar.CanEdit description: "Whether the user can write to the calendar (true for the user who created the calendar and for a user who has been shared a calendar and granted write access)." type: Boolean - contextPath: MSGraphCalendar.Calendar.ChangeKey description: "Identifies the version of the calendar object. Every time the calendar is changed, the changeKey changes as well, which allows the exchange to apply changes to the correct version of the object. Read-only." type: String - contextPath: MSGraphCalendar.Calendar.Owner description: "The user who created or added the calendar." type: Unknown - contextPath: MSGraphCalendar.Calendar.ID description: The unique ID of the calendar. Read-only. type: String - contextPath: MSGraphCalendar.Calendar.CanViewPrivateItems description: Whether the user can read calendar items that have been marked private. type: Boolean - name: msgraph-calendar-get-calendar description: Retrieves one of user's Calendars. arguments: - name: user description: The user ID or the userPrincipalName. - name: calendar_id description: The calendar ID or name. If not specified, it retrieves the user's default calendar. outputs: - contextPath: MSGraphCalendar.Calendar.Name description: The name of the calendar. type: String - contextPath: MSGraphCalendar.Calendar.CanShare description: "Whether the user has the permission to share the calendar. Only the user who created the calendar can share it." type: Boolean - contextPath: MSGraphCalendar.Calendar.CanEdit description: "Whether the user can write to the calendar (true for the user who created the calendar and for a user who has been shared a calendar and granted write access)." type: Boolean - contextPath: MSGraphCalendar.Calendar.ChangeKey description: "Identifies the version of the calendar object. Every time the calendar is changed, the changeKey changes as well, which allows the Exchange to apply changes to the correct version of the object. Read-only." type: String - contextPath: MSGraphCalendar.Calendar.Owner description: "The user who created or added the calendar." type: Unknown - contextPath: MSGraphCalendar.Calendar.ID description: The unique ID of the calendar. Read-only. type: String - contextPath: MSGraphCalendar.Calendar.CanViewPrivateItems description: Whether the user can read calendar items that have been marked private. - name: msgraph-calendar-list-events description: Retrieves a list of Calendar's events. arguments: - name: user description: The User ID or userPrincipalName. - name: calendar_id description: The calendar ID or name. If not provided, the default calendar is used. - name: order_by description: Sorts the order of the items returned from Microsoft Graph. - name: next_link description: Link for the next page of results, if it exists. See docs.microsoft.com/en-us/graph/api/event-list?view=graph-rest-1.0 for more details. - name: top description: Specifies the page size of the result set. - name: filter_by description: Filter Results. For more information, see https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter. outputs: - contextPath: MSGraphCalendar.ID description: User's ID. type: Unknown - contextPath: MSGraphCalendar.DisplayName description: The display name of the user. type: Unknown - contextPath: MSGraphCalendar.GivenName description: The given name of the user. type: Unknown - contextPath: MSGraphCalendar.BusinessPhones description: The business phone numbers of the user. type: Unknown - contextPath: MSGraphCalendar.JobTitle description: The job title of the user. type: Unknown - contextPath: MSGraphCalendar.Mail description: The mail address of the user. type: Unknown - contextPath: MSGraphCalendar.MobilePhone description: The mobile phone number of the user. type: Unknown - contextPath: MSGraphCalendar.OfficeLocation description: The office location of the user. type: Unknown - contextPath: MSGraphCalendar.PreferredLanguage description: The preferred language of the user. type: Unknown - contextPath: MSGraphCalendar.Surname description: The surname of the user. type: Unknown - contextPath: MSGraphCalendar.UserPrincipalName description: The principal name of the user. type: Unknown - name: msgraph-calendar-get-event description: Retrieves an event by event ID. arguments: - name: user description: The user ID or the userPrincipalName. - name: event_id description: The event ID. required: true outputs: - contextPath: MSGraphCalendar.Event.OriginalStartTimeZone description: The start time zone when the event was created. type: String - contextPath: MSGraphCalendar.Event.HasAttachments description: Whether the event has attachments. type: Boolean - contextPath: MSGraphCalendar.Event.ResponseRequested description: Whether the sender requests a response when the event is accepted or declined. type: Boolean - contextPath: MSGraphCalendar.Event.WebLink description: The URL to open the event in Outlook on the web. type: String - contextPath: MSGraphCalendar.Event.Recurrence description: The recurrence pattern for the event. type: Unknown - contextPath: MSGraphCalendar.Event.Start description: The date, time, and time zone that the event starts. By default, the start time is in UTC. type: Unknown - contextPath: MSGraphCalendar.Event.End description: The date, time, and time zone that the event ends. By default, the end time is in UTC. type: Unknown - contextPath: MSGraphCalendar.Event.Location description: The location of the event. type: Unknown - contextPath: MSGraphCalendar.Event.Attendees description: The collection of attendees for the event. type: Unknown - contextPath: MSGraphCalendar.Event.Type description: The event type. For example, singleInstance, occurrence, exception, seriesMaster. Read-only. type: String - contextPath: MSGraphCalendar.Event.ResponseStatus.response description: Indicates the type of response sent in response to an event message. type: Unknown - contextPath: MSGraphCalendar.Event.Importance description: The importance of the event. For example, low, normal, high. type: String - contextPath: MSGraphCalendar.Event.ICalUId description: A unique identifier that is shared by all instances of an event across different calendars. type: String - contextPath: MSGraphCalendar.Event.IsCancelled description: Whether the event has been canceled. type: Boolean - contextPath: MSGraphCalendar.Event.IsAllDay description: Whether the event lasts all day. type: Boolean - contextPath: MSGraphCalendar.Event.ReminderMinutesBeforeStart description: The number of minutes before the event start time of the reminder alert. type: Number - contextPath: MSGraphCalendar.Event.LastModifiedDateTime description: "The last time the event was modified, using ISO 8601 format in in UTC time. For example, midnight UTC on Jan 1, 2014 is '2014-01-01T00:00:00Z'." type: String - contextPath: MSGraphCalendar.Event.OriginalEndTimeZone description: The end time zone when the event was created. type: String - contextPath: MSGraphCalendar.Event.CreatedDateTime description: "The date the event was created using ISO 8601 format in UTC time. For example, midnight UTC on Jan 1, 2014 would be: '2014-01-01T00:00:00Z'." type: String - contextPath: MSGraphCalendar.Event.ChangeKey description: "Identifies the version of the event object. Every time the event is changed, the ChangeKey changes as well, which allows the Exchange to apply changes to the correct version of the object." type: String - contextPath: MSGraphCalendar.Event.ID description: The ID of the event. type: String - contextPath: MSGraphCalendar.Event.IsOrganizer description: Whether the message sender is also the organizer. type: Boolean - contextPath: MSGraphCalendar.Event.Sensitivity description: "The sensitivity of the event. Possible values are: normal, personal, private, confidential." type: String - contextPath: MSGraphCalendar.Event.IsReminderOn description: Whether an alert is set to remind the user of the event. type: Boolean - contextPath: MSGraphCalendar.Event.Organizer description: The organizer of the event. type: Unknown - contextPath: MSGraphCalendar.Event.Subject description: The text of the event's subject line. type: String - contextPath: MSGraphCalendar.Event.OnlineMeetingUrl description: "A URL for an online meeting, which is used when an organizer specifies an event as an online meeting, such as a Skype meeting. Read-only." type: Unknown - name: msgraph-calendar-create-event description: Creates a new event. arguments: - name: user description: The user ID or userPrincipalName. - name: calendar_id description: The unique ID of the Calendar or name. If not provided, the default calendar is used. - name: attendees description: The collection of attendees for the event. - name: body description: The body of the message associated with the event in HTML or text format. - name: subject description: The text of the event's subject line. - name: location description: The location of the event for an online meeting, such as a Skype meeting. Read-only. - name: end description: "The date and time the event ends. For example, '2017-05-28T12:00:00'. By default, the start time is in UTC." - name: original_end_time_zone description: The end time zone when the event was created. - name: original_start description: "The original start time of the calendar item using ISO 8601 format in UTC time. For example, midnight UTC on Jan 1, 2014 is '2014-01-01T00:00:00Z'." - name: start description: "The date and time the event starts at, for example '2017-05-28T12:00:00'. By default, the start time is in UTC." - name: time_zone description: "Represents a time zone. For example, 'Pacific Standard Time'. For more information, see https://docs.microsoft.com/en-us/graph/api/resources/datetimetimezone?view=graph-rest-1.0" - name: original_start_time_zone description: The start time zone when the event was created. outputs: - contextPath: MSGraphCalendar.Event.OriginalStartTimeZone description: The start time zone when the event was created. type: String - contextPath: MSGraphCalendar.Event.HasAttachments description: Whether the event has attachments. type: Boolean - contextPath: MSGraphCalendar.Event.ResponseRequested description: Whether the sender would like a response when the event is accepted or declined. type: Boolean - contextPath: MSGraphCalendar.Event.WebLink description: The URL to open the event in Outlook on the web. type: String - contextPath: MSGraphCalendar.Event.Recurrence description: The recurrence pattern for the event. type: Unknown - contextPath: MSGraphCalendar.Event.Start description: The date, time, and time zone that the event starts. By default, the start time is in UTC. type: Unknown - contextPath: MSGraphCalendar.Event.End description: The date, time, and time zone that the event ends. By default, the end time is in UTC. type: Unknown - contextPath: MSGraphCalendar.Event.Location description: The location of the event. type: Unknown - contextPath: MSGraphCalendar.Event.Attendees description: The collection of attendees for the event. type: Unknown - contextPath: MSGraphCalendar.Event.Type description: The event type. For example, singleInstance, occurrence, exception, seriesMaster. Read-only. type: String - contextPath: MSGraphCalendar.Event.ResponseStatus.response description: Indicates the type of response sent in response to an event message. type: Unknown - contextPath: MSGraphCalendar.Event.Importance description: The importance of the event. For example, low, normal, high. type: String - contextPath: MSGraphCalendar.Event.ICalUId description: A unique identifier that is shared by all instances of an event across different calendars. type: String - contextPath: MSGraphCalendar.Event.IsCancelled description: Whether the event has been canceled. type: Boolean - contextPath: MSGraphCalendar.Event.IsAllDay description: Whether the event lasts all day. type: Boolean - contextPath: MSGraphCalendar.Event.ReminderMinutesBeforeStart description: The number of minutes before the event start time of the reminder alert. type: Number - contextPath: MSGraphCalendar.Event.LastModifiedDateTime description: "Last modified time and date of the event using ISO 8601 format in UTC time. For example, midnight UTC on Jan 1, 2014 is '2014-01-01T00:00:00Z'." type: String - contextPath: MSGraphCalendar.Event.OriginalEndTimeZone description: The end time zone when the event was created. type: String - contextPath: MSGraphCalendar.Event.CreatedDateTime description: "The time and date the event was created using ISO 8601 format in UTC time. For example, midnight UTC on Jan 1, 2014 is '2014-01-01T00:00:00Z'." type: String - contextPath: MSGraphCalendar.Event.ChangeKey description: "Identifies the version of the event object. Every time the event is changed, the ChangeKey changes as well, which allows the Exchange to apply changes to the correct version of the object." type: String - contextPath: MSGraphCalendar.Event.ID description: Event's ID. type: String - contextPath: MSGraphCalendar.Event.IsOrganizer description: Whether the message sender is also the organizer. type: Boolean - contextPath: MSGraphCalendar.Event.Sensitivity description: "The sensitivity of the event. Possible values are: normal, personal, private, confidential." type: String - contextPath: MSGraphCalendar.Event.IsReminderOn description: Whether an alert is set to remind the user of the event. type: Boolean - contextPath: MSGraphCalendar.Event.Organizer description: The organizer of the event. type: Unknown - contextPath: MSGraphCalendar.Event.Subject description: The text of the event's subject line. type: String - contextPath: MSGraphCalendar.Event.OnlineMeetingUrl description: "A URL for an online meeting, which is used only when an organizer specifies an event as an online meeting, such as a Skype meeting. Read-only." type: Unknown - name: msgraph-calendar-update-event description: Updates an existing event. arguments: - name: user description: The user ID or userPrincipalName. - name: event_id description: The event ID. required: true - name: attendees description: The collection of attendees for the event. - name: body description: The body of the message associated with the event. It can be in HTML or text format. - name: subject description: The text of the event's subject line. - name: location description: The location of the event for an online meeting, such as a Skype meeting. Read-only. - name: end description: "The date and time the event ends. For example '2017-05-28T12:00:00'. By default, the start time is in UTC." - name: original_end_time_zone description: The end time zone when the event was created. - name: start description: "The date and time the event starts. For example '2017-05-28T12:00:00'. By default, the start time is in UTC." - name: time_zone description: "Represents a time zone, for example, 'Pacific Standard Time'. For more information, see https://docs.microsoft.com/en-us/graph/api/resources/datetimetimezone?view=graph-rest-1.0" - name: original_start description: "The original start time of the calendar item, using ISO 8601 format in UTC time. For example, midnight UTC on Jan 1, 2014 is '2014-01-01T00:00:00Z'." - name: original_start_time_zone description: The start time zone when the event was created. outputs: - contextPath: MSGraphCalendar.Event.OriginalStartTimeZone description: The start time zone when the event was created. type: String - contextPath: MSGraphCalendar.Event.HasAttachments description: Whether the event has attachments. type: Boolean - contextPath: MSGraphCalendar.Event.ResponseRequested description: Whether the sender requests a response when the event is accepted or declined. type: Boolean - contextPath: MSGraphCalendar.Event.WebLink description: The URL to open the event in Outlook on the web. type: String - contextPath: MSGraphCalendar.Event.Recurrence description: The recurrence pattern for the event. type: Unknown - contextPath: MSGraphCalendar.Event.Start description: The date, time, and time zone that the event starts. By default, the start time is in UTC. type: Unknown - contextPath: MSGraphCalendar.Event.End description: The date, time, and time zone that the event ends. By default, the end time is in UTC. type: Unknown - contextPath: MSGraphCalendar.Event.Location description: The location of the event. type: Unknown - contextPath: MSGraphCalendar.Event.Attendees description: The collection of attendees for the event. type: Unknown - contextPath: MSGraphCalendar.Event.Type description: The event type. For example, singleInstance, occurrence, exception, seriesMaster. Read-only. type: String - contextPath: MSGraphCalendar.Event.ResponseStatus.response description: Indicates the type of response sent in response to an event message. type: Unknown - contextPath: MSGraphCalendar.Event.Importance description: The importance of the event. For example, low, normal, high. type: String - contextPath: MSGraphCalendar.Event.ICalUId description: A unique identifier that is shared by all instances of an event across different calendars. type: String - contextPath: MSGraphCalendar.Event.IsCancelled description: Whether the event has been canceled. type: Boolean - contextPath: MSGraphCalendar.Event.IsAllDay description: Whether the event lasts all day. type: Boolean - contextPath: MSGraphCalendar.Event.ReminderMinutesBeforeStart description: The number of minutes before the event start time of the reminder alert. type: Number - contextPath: MSGraphCalendar.Event.LastModifiedDateTime description: "The last time and date the event was modified using ISO 8601 format in UTC time. For example, midnight UTC on Jan 1, 2014 is '2014-01-01T00:00:00Z'." type: String - contextPath: MSGraphCalendar.Event.OriginalEndTimeZone description: The end time zone that was set when the event was created. type: String - contextPath: MSGraphCalendar.Event.CreatedDateTime description: "The date and time the event was created using ISO 8601 format in UTC time. For example, midnight UTC on Jan 1, 2014 is '2014-01-01T00:00:00Z'." type: String - contextPath: MSGraphCalendar.Event.ChangeKey description: "Identifies the version of the event object. Every time the event is changed, the ChangeKey changes as well, which allows Exchange to apply changes to the correct version of the object." type: String - contextPath: MSGraphCalendar.Event.ID description: The ID of the event. type: String - contextPath: MSGraphCalendar.Event.IsOrganizer description: Whether the message sender is also the organizer. type: Boolean - contextPath: MSGraphCalendar.Event.Sensitivity description: "The sensitvity of the event. Possible values are: normal, personal, private, confidential." type: String - contextPath: MSGraphCalendar.Event.IsReminderOn description: Whether an alert is set to remind the user of the event. type: Boolean - contextPath: MSGraphCalendar.Event.Organizer description: The organizer of the event. type: Unknown - contextPath: MSGraphCalendar.Event.Subject description: The text of the event's subject line. type: String - contextPath: MSGraphCalendar.Event.OnlineMeetingUrl description: "A URL for an online meeting, used only when an organizer specifies an event as an online meeting, such as a Skype meeting. Read-only." type: Unknown - name: msgraph-calendar-delete-event description: Updates an existing event. arguments: - name: user description: The user ID or userPrincipalName. - name: event_id description: The event ID. required: true outputs: - contextPath: MSGraphCalendar.Event.OriginalStartTimeZone description: The start time zone when the event was created. type: String - contextPath: MSGraphCalendar.Event.HasAttachments description: Whether the event has attachments. type: Boolean - contextPath: MSGraphCalendar.Event.ResponseRequested description: Whether the sender receives a response when the event is accepted or declined. type: Boolean - contextPath: MSGraphCalendar.Event.WebLink description: The URL to open the event in Outlook on the web. type: String - contextPath: MSGraphCalendar.Event.Recurrence description: The recurrence pattern for the event. type: Unknown - contextPath: MSGraphCalendar.Event.Start description: The date, time, and time zone that the event starts. By default, the start time is in UTC. type: Unknown - contextPath: MSGraphCalendar.Event.End description: The date, time, and time zone that the event ends. By default, the end time is in UTC. type: Unknown - contextPath: MSGraphCalendar.Event.Location description: The location of the event. type: Unknown - contextPath: MSGraphCalendar.Event.Attendees description: The collection of attendees for the event. type: Unknown - contextPath: MSGraphCalendar.Event.Type description: The event type. For example, singleInstance, occurrence, exception, seriesMaster. Read-only. type: String - contextPath: MSGraphCalendar.Event.ResponseStatus.response description: Indicates the type of response sent in response to an event message. type: Unknown - contextPath: MSGraphCalendar.Event.Importance description: The importance of the event. For example, low, normal, high. type: String - contextPath: MSGraphCalendar.Event.ICalUId description: A unique identifier that is shared by all instances of an event across different calendars. type: String - contextPath: MSGraphCalendar.Event.IsCancelled description: Whether the event has been canceled. type: Boolean - contextPath: MSGraphCalendar.Event.IsAllDay description: Whether the event lasts all day. type: Boolean - contextPath: MSGraphCalendar.Event.ReminderMinutesBeforeStart description: The number of minutes before the event start time of the reminder alert. type: Number - contextPath: MSGraphCalendar.Event.LastModifiedDateTime description: "The time and date the event was last modified using the ISO 8601 format in UTC time. For example, midnight UTC on Jan 1, 2014 is '2014-01-01T00:00:00Z'." type: String - contextPath: MSGraphCalendar.Event.OriginalEndTimeZone description: The end time zone that was set when the event was created. type: String - contextPath: MSGraphCalendar.Event.CreatedDateTime description: "The time and date the event was created using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is '2014-01-01T00:00:00Z'." type: String - contextPath: MSGraphCalendar.Event.ChangeKey description: "Identifies the version of the event object. Every time the event is changed, the ChangeKey changes as well, which allows the Exchange to apply changes to the correct version of the object." type: String - contextPath: MSGraphCalendar.Event.ID description: The ID of the Event. type: String - contextPath: MSGraphCalendar.Event.IsOrganizer description: Whether the message sender is also the organizer. type: Boolean - contextPath: MSGraphCalendar.Event.Sensitivity description: "The sensitivity of the event. Possible values are: normal, personal, private, confidential." type: String - contextPath: MSGraphCalendar.Event.IsReminderOn description: Whether an alert is set to remind the user of the event. type: Boolean - contextPath: MSGraphCalendar.Event.Organizer description: The organizer of the event. type: Unknown - contextPath: MSGraphCalendar.Event.Subject description: The text of the event's subject line. type: String - contextPath: MSGraphCalendar.Event.OnlineMeetingUrl description: "A URL for an online meeting, used only when an organizer specifies an event as an online meeting, such as a Skype meeting. Read-only." type: Unknown - description: Run this command if for some reason you need to rerun the authentication process. execution: false name: msgraph-calendar-auth-reset arguments: [] dockerimage: demisto/crypto:1.0.0.5490413 runonce: false script: '-' type: python subtype: python3 tests: - Microsoft Graph Calendar - Test - Microsoft Graph Calendar - Test dev fromversion: 5.0.0