This documentation is in maintenance status and may not reflect the latest product updates. Please see the release notes for product updates.

Exchange Online retrieve calendar items

Nintex external platform is required for this feature. For details, see Enable Nintex external platform features.

Retrieves calendar items from Exchange Online.

Action settings

Following are the fields and options visible in the configuration settings dialog box for this action.

Section	Field	Description
(unlabeled)	Time zone	Select the time zone for the specified search window. Default value: UTC.
	Items occurring after	Return items occurring after this time.
	Items occurring before	Return items occurring before this time.
	Maximum results	Specify the maximum number of results to return, up to 100 items.
Credentials	Authorizing user	Important: Due to Microsoft deprecating basic authentication, the Username and Password fields in the configuration of this action has been replaced with the new Authorizing user field. If you have existing workflows using this action, you must update the configuration. Existing workflows with the old version of the action will continue to run till basic authentication is deprecated by Microsoft. After it's deprecated the action will fail at execution if the configuration is not updated. Specify an email address for the authorization request. External email addresses can be used. Steps in the authorization process On execution of the action, a message is sent to the email address specified for the authorizing user. The message contains the following details. From: notification@nintexlive.com Subject: Contains the phrases "Nintex" and "Request authorization" Contents: Contains links to authorize or deny the operation When the authorizing user clicks the link to authorize the operation, the authorizing user is prompted to do the following. Log in to the external service Allow Nintex to access the external service Decide whether to waive future Nintex authorization requests for this external service When the prompted actions are completed, the action completes. What happens if the operation is never authorized? If the authorization process is not completed, then the workflow suspends. This situation can occur in the following scenarios. The authorizing user explicitly denies the operation, either by clicking the deny link in the email message or not allowing Nintex access to the external service after logging in. Error logged for suspended workflow: “The service request has been denied.” Seven days pass without completion of the authorization process. Either the authorizing user never clicks the authorize link in the email message or the authorizing user initiates the process but does not complete all steps. For example, the authorizing user logs in to the external service but does not allow Nintex to access the external service. Error logged for suspended workflow: “The service request has expired.”
	Exchange version	Specify the version of Exchange Online.
	User to impersonate	Specify a user to impersonate. This allows an account with the appropriate permissions to retrieve items from the user’s calendar.
(unlabeled)	Output	Store output for this action using the following selections. Calendar item ID: Specify a collection variable to store the calendar item's ID. Subject: Specify a collection variable to store the calendar item's subject. Location: Specify a collection variable to store the calendar item's location. Message body: Specify a collection variable to store the calendar item's details. Start time: Specify a collection variable to store the calendar item's start time in the specified time zone. End time: Specify a collection variable to store the calendar item's end time in the specified time zone. All day event: Specify a collection variable to store whether or not the calendar item is an all day event. Reminder (minutes): Specify a collection variable to store the number of minutes the reminder is set to for a calendar item. Show time as: Specify a collection variable to store the calendar appearance of the calendar item's time. Importance: Specify a collection variable to store the calendar item's importance. Category: Specify a collection variable to store the calendar item's category. Private: Specify a collection variable to store whether or not the calendar item is private. Required: Specify a collection variable to store the calendar item's required attendees. Optional: Specify a collection variable to store the calendar item's optional attendees. Request response: Specify a collection variable to store whether or not responses have been requested for the calendar item. Allow new time proposals: Specify a collection variable to store whether or not new time proposals are allowed for the calendar item. Result count: Specify a numeric variable to store the number of results. How to add and remove output variables Depending on action requirements, you may be able to add and remove output variables. To add an output variable Select an option from the Select more drop-down list. Click Add to display a drop-down list for the selected option. Select a previously defined workflow variable from the drop-down list. To remove an output variable Click Delete (). Note: Some output variables cannot be deleted. For example, the output variable URL for the action Bing news search cannot be deleted.