From 7068fd4d4b7595cdb247453d1cc287d3371655ca Mon Sep 17 00:00:00 2001 From: harshilp24 Date: Tue, 15 Apr 2025 17:21:10 +0530 Subject: [PATCH 1/3] feat: Outlook --- .../docs/connect-data/reference/outlook.md | 522 ++++++++++++++++++ website/sidebars.js | 1 + 2 files changed, 523 insertions(+) create mode 100644 website/docs/connect-data/reference/outlook.md diff --git a/website/docs/connect-data/reference/outlook.md b/website/docs/connect-data/reference/outlook.md new file mode 100644 index 0000000000..523425b30e --- /dev/null +++ b/website/docs/connect-data/reference/outlook.md @@ -0,0 +1,522 @@ +# Outlook + +This page provides information on how to connect to Outlook. This integration enables you to manage calendars and events, such as creating and updating calendar events in a user's Outlook account. + +## Connect Outlook + +To connect to Outlook, you must authenticate using an OAuth2 connection. After initiating the connection, sign in with your Microsoft account and authorize access to calendar-related permissions. Once connected, you can interact with calendars and events using the available commands. Ensure you select the appropriate user ID and calendar ID for accessing or modifying events. + +## Query Outlook + +The following section is a reference guide that provides a description of the available commands with their parameters to create Outlook queries. + +### Create Event + +Creates a new calendar event in Outlook for a specified user. You can define details such as the subject, timing, attendees, and event location. + +#### user id `string` + +
+ +Unique identifier of the Outlook user whose calendar the event is created in. + +To find the User ID, use Microsoft Graph API’s /users endpoint, or refer to the authenticated user context. In organization accounts, administrators can retrieve this from Azure Active Directory. + +
+ +#### Subject `string` + +
+ +Title or summary of the calendar event. Appears as the event label on the calendar. + +
+ +#### Start Time `string` + +
+ +Start time of the event in ISO 8601 format (e.g., 2025-04-15T10:00:00). Must be used along with Time Zone. + +
+ +#### Time Zone `string` + +
+ +Time zone for both Start Time and End Time. Use standard names like UTC, Pacific Standard Time, Eastern Standard Time, etc. + +
+ +#### End Time `string` + +
+ +End time of the event in ISO 8601 format. Must be after the Start Time and aligned with the same Time Zone. + +
+ +#### Calendar ID `string` + +
+ +ID of the calendar where the event is added. +To retrieve Calendar ID, use the Microsoft Graph API endpoint `/users/{user-id}/calendars`. The default calendar typically has the ID "calendar". + +
+ +#### Description `string` + +
+ +Optional body text describing the event's agenda, context, or any additional notes. + +
+ +#### Content Type `string` + +
+ +Format of the event description. Use "text" for plain text or "html" for rich content. + +
+ +#### Location Name `string` + +
+ +Name of the event's physical or virtual location — such as a conference room or meeting space. + +
+ +#### Location URL `string` + +
+ +Optional URL for a virtual meeting or reference link (e.g., Teams, Zoom, Google Meet). + +
+ +#### Attendees `array` + +
+ +List of attendees for the event. Each attendee should include an email and optionally their role (e.g., required, optional). + +
+ +### Update Event + +Updates an existing calendar event in Outlook. Use this to modify subject, timing, location, attendees, and other details. + +#### User ID `string` + +
+ +Unique identifier of the Outlook user whose calendar event is being updated. Refer to Microsoft Graph API or user context to retrieve this value. + +
+ +#### Event ID `string` + +
+ +Unique identifier of the event to be updated. +Use Microsoft Graph API’s `/users/{user-id}/calendars/{calendar-id}/events` to list events and find their Event ID. + +
+ +#### Subject `string` + +
+ +Updated event title or summary. + +
+ +#### Start Time `string` + +
+ +Updated start time in ISO 8601 format. + +
+ +#### Time Zone `string` + +
+ +Updated time zone for the event time fields. + +
+ +#### End Time `string` + +
+ +Updated end time in ISO 8601 format. + +
+ +#### Calendar ID `string` + +
+ +ID of the calendar containing the event. + +
+ + +#### Description `string` + +
+ +Updated event description or body content. + +
+ +#### Content Type `string` + +
+ +Updated format of the description — either "text" or "html". + +
+ +#### Location Name `string` + +
+ +Updated location name for the event. + +
+ +#### Location URL `string` + +
+ +Updated URL for virtual meeting or location reference. + +
+ +#### Attendees `array` + +
+ +Updated list of attendees. Replaces the previous attendee list entirely. Include email and role for each attendee. + +
+ +### Get Event by ID + +Retrieves detailed information for a specific calendar event in Outlook using its unique identifier. Use this to fetch full event data including subject, time, attendees, and location. + +#### User ID `string` + +
+ +Unique identifier of the Outlook user whose calendar contains the event. +To retrieve the User ID, use the Microsoft Graph API endpoint `/users`, or access the authenticated user context. In enterprise environments, administrators can locate this in Azure Active Directory. + +
+ +#### Event ID `string` + +
+ +Unique identifier of the event to retrieve. +To find the Event ID, use the Microsoft Graph API endpoint `/users/{user-id}/calendars/{calendar-id}/events`. Each event object returned includes an id field representing the Event ID. + +
+ +#### Calendar ID `string` + +
+ +Identifier of the calendar that contains the event. +Use Microsoft Graph API’s `/users/{user-id}/calendars` endpoint to list all calendars and locate the appropriate Calendar ID. The default calendar usually has the static ID "calendar". + +
+ +### Delete Event + +Deletes a specific event from a user's Outlook calendar. Use this to permanently remove an event based on its identifiers. + +#### User ID `string` + +
+ +Unique identifier of the Outlook user whose calendar contains the event. +Retrieve the User ID using the Microsoft Graph API `endpoint /users`, or from the authenticated user context. In organizational accounts, administrators can access this via Azure Active Directory. + +
+ +#### Event ID `string` + +
+ +Unique identifier of the event to be deleted. +To locate the Event ID, use the Microsoft Graph API endpoint `/users/{user-id}/calendars/{calendar-id}/events`. The id field in each event object corresponds to the Event ID. + +
+ +#### Calendar ID `string` + +
+ +Identifier of the calendar from which the event should be deleted. +Use the Microsoft Graph API `/users/{user-id}/calendars` to list all calendars associated with the user. The default calendar typically uses the ID "calendar". + +
+ +### Get Messages + +Retrieves email messages from a specific folder in a user's Outlook mailbox. Use this command to fetch messages with optional filters and result limits. + +#### User ID `string` + +
+ +Unique identifier of the Outlook user whose mailbox is being accessed. +To retrieve the User ID, use Microsoft Graph API's `/users` endpoint. For personal accounts, the authenticated context typically provides the ID automatically. In enterprise accounts, administrators can obtain it from Azure Active Directory. + +Example commands to get User ID: + +- Use: `GET /users` (for organization-wide listing) + +- Use: `GET /me` (for authenticated user) + +
+ +#### Mail Folder `string` + +
+ +The folder within the user's mailbox from which to retrieve messages. Common folders include "Inbox", "SentItems", and "Archive". +Use the Microsoft Graph API endpoint `/users/{user-id}/mailFolders` to list available folders and get their IDs. + +
+ +#### Messages Filter Formula `string` + +
+ +Optional Data filter to narrow down the messages based on specific conditions. Use standard Microsoft Graph filtering syntax. + +*Example 1:* If you want to fetch messages from a specific sender: + +```plaintext +from/emailAddress/address eq 'alice@example.com' +``` + +*Example 2:* If you want to get messages received after a specific date: + + +```plaintext +receivedDateTime ge 2025-04-01T00:00:00Z +``` + +*Example 3:* If you want to find unread messages with attachments: + +```plaintext +isRead eq false and hasAttachments eq true +``` + +Filters can be combined using logical operators such as and, or, etc. + +
+ +#### Limit Results `number` + +
+ +Specifies the maximum number of messages to return. This helps manage large datasets by retrieving only a subset of records. + +*Example 1:* To fetch the 10 most recent messages in the inbox: +Set Limit Results to 10. + +*Example 2:* To display a quick preview or summary (e.g., first 5 emails for a dashboard): +Set Limit Results to 5. + +This value controls the top parameter in the Graph API request: + +```plaintext +?$top=5 +``` + +
+ + +### Send Message +Sends an email message from a specified Outlook user. You can include recipients, content formatting, attachments, and optionally specify a folder to save the sent message. + +#### User ID `string` + +
+ +Unique identifier of the Outlook user from whose account the email is sent. +Retrieve the User ID using Microsoft Graph API’s /users endpoint, or refer to the current authenticated session via /me. For organizational accounts, the ID can also be accessed via Azure Active Directory. + +
+ +#### Subject `string` + +
+The subject line of the email message. Appears as the main title in the recipient’s inbox. + +
+ +#### Message Body `string` + +
+ +The main content of the email message. Use plain text or HTML depending on the Content Type. + +
+ +#### Content Type `string` + +
+ +Specifies the format of the Message Body. Accepted values are: + +- text – for plain text content + +- html – for rich text or HTML-formatted emails + +
+ +#### Attachments `array` + +
+ +Optional list of attachments to include with the message. Each attachment object should contain a name, content type, and base64-encoded content string. +Use this to attach documents, images, or files as needed. + +
+ +#### To Recipients `array` + +
+ +List of primary recipients for the email. Each item should include an email address. +These addresses appear in the To field of the message. + +
+ +#### CC Recipients `array` + +
+ +List of recipients to be copied on the email. These addresses appear in the CC field. +Each recipient must be specified with a valid email address. + +
+ +#### BCC Recipients `array` + +
+ +List of recipients to be blind copied on the email. These addresses are hidden from other recipients and appear in the BCC field. + +
+ +#### Mail Folder `string` + +
+ +Optional folder to store the sent message. +Use Microsoft Graph API’s `/users/{user-id}/mailFolders` to list available folders. To save the sent message in a custom or predefined folder (e.g., "SentItems"), provide the folder ID here. If not specified, the message is saved in the default sent folder. + +
+ + +### Custom Action + +Performs a custom API call to Microsoft Graph, allowing access to Outlook features beyond predefined commands. Use this to interact with endpoints that are not available as built-in commands. + +You can define your own request by specifying the HTTP method, endpoint URL, headers, and body parameters. This is useful for advanced use cases or newer Microsoft Graph endpoints that are not yet integrated into the standard command set. + +
+ +Example 1: Mark a Message as Read + You want to mark a specific email message as read after processing it in your app. + +Endpoint: + +```http +PATCH /users/{user-id}/messages/{message-id} +``` + +Headers: + +```json +{ + "Content-Type": "application/json" +} +``` + +Body: + +```json +{ + "isRead": true +} +``` + +*Example 2:* Move a Message to a Different Folder + Automatically move an incoming email from the inbox to a custom folder after tagging or filtering it. + +Endpoint: + +```http +POST /users/{user-id}/messages/{message-id}/move +``` + +Headers: + +```json +{ + "Content-Type": "application/json" +} +``` + +Body: + +```json +{ + "destinationId": "AAMkAGVmMDEz..." // The folder ID of the target destination +} +``` + +*Example 3:* Get Calendar View (Events in a Time Range) + +You want to fetch all events for a user within a specific time window — useful for building scheduling dashboards or calendar overviews. + +Endpoint: + +```http +GET /users/{user-id}/calendarView?startDateTime=2025-04-01T00:00:00Z&endDateTime=2025-04-30T23:59:59Z +``` + +This returns all events between the provided dates. You can also apply filters or select specific fields using query parameters. + +Example 4: Get User’s Mail Tips + Before sending an email, you want to check if recipients are out of office or if there are automatic replies configured. + +Endpoint: + +```http +POST /users/{user-id}/getMailTips +``` + +Body: + +```json +{ + "EmailAddresses": ["user@example.com"], + "MailTipsOptions": "automaticReplies" +} +``` + +
\ No newline at end of file diff --git a/website/sidebars.js b/website/sidebars.js index c0abe360a3..64d87b3772 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -325,6 +325,7 @@ const sidebars = { 'connect-data/reference/querying-google-sheets', 'connect-data/reference/hubspot', 'connect-data/reference/jira', + 'connect-data/reference/outlook', 'connect-data/reference/slack', 'connect-data/reference/twilio', 'connect-data/reference/zendesk', From d70c15f5a5ca560cab79e38ef9b8efca5c11dc53 Mon Sep 17 00:00:00 2001 From: harshilp24 Date: Thu, 17 Apr 2025 14:50:27 +0530 Subject: [PATCH 2/3] ... --- .../docs/connect-data/reference/outlook.md | 188 +++++++++++++----- 1 file changed, 137 insertions(+), 51 deletions(-) diff --git a/website/docs/connect-data/reference/outlook.md b/website/docs/connect-data/reference/outlook.md index 523425b30e..814ad34ddb 100644 --- a/website/docs/connect-data/reference/outlook.md +++ b/website/docs/connect-data/reference/outlook.md @@ -4,7 +4,7 @@ This page provides information on how to connect to Outlook. This integration en ## Connect Outlook -To connect to Outlook, you must authenticate using an OAuth2 connection. After initiating the connection, sign in with your Microsoft account and authorize access to calendar-related permissions. Once connected, you can interact with calendars and events using the available commands. Ensure you select the appropriate user ID and calendar ID for accessing or modifying events. +To connect to Outlook, you must authenticate using an OAuth2 connection. After initiating the connection, sign in with your Microsoft account and authorize access to calendar-related permissions. Ensure you select the appropriate user ID and calendar ID for accessing or modifying events. ## Query Outlook @@ -14,13 +14,15 @@ The following section is a reference guide that provides a description of the av Creates a new calendar event in Outlook for a specified user. You can define details such as the subject, timing, attendees, and event location. -#### user id `string` +#### User ID `string`
Unique identifier of the Outlook user whose calendar the event is created in. -To find the User ID, use Microsoft Graph API’s /users endpoint, or refer to the authenticated user context. In organization accounts, administrators can retrieve this from Azure Active Directory. +This should be an email address associated with a Microsoft account, such as `user@outlook.com` or a work email from Microsoft 365 (e.g., `user@company.com`). + +Gmail or other non-Microsoft domains are not supported unless linked to a Microsoft identity.
@@ -28,7 +30,7 @@ To find the User ID, use Microsoft Graph API’s /users endpoint, or refer to th
-Title or summary of the calendar event. Appears as the event label on the calendar. +Title or summary of the calendar event. This appears prominently on the user’s calendar view, mobile app, and any synced notifications.
@@ -36,7 +38,18 @@ Title or summary of the calendar event. Appears as the event label on the calend
-Start time of the event in ISO 8601 format (e.g., 2025-04-15T10:00:00). Must be used along with Time Zone. + +Defines when the event begins. This must follow ISO 8601 format, such as: + +```js +2025-04-15T10:00:00 +``` + +You can also dynamically generate this from a Date widget: + +```js +{{ startDatePicker.selectedDate }} +```
@@ -44,8 +57,9 @@ Start time of the event in ISO 8601 format (e.g., 2025-04-15T10:00:00). Must be
-Time zone for both Start Time and End Time. Use standard names like UTC, Pacific Standard Time, Eastern Standard Time, etc. +The time zone in which the Start and End times are interpreted. +Providing the correct time zone ensures events display accurately for attendees across regions.
#### End Time `string` @@ -60,8 +74,14 @@ End time of the event in ISO 8601 format. Must be after the Start Time and align
-ID of the calendar where the event is added. -To retrieve Calendar ID, use the Microsoft Graph API endpoint `/users/{user-id}/calendars`. The default calendar typically has the ID "calendar". +The unique identifier of the calendar where the event will be created. + +For most users, the default calendar has an ID of `calendar`. However, users may have multiple calendars, including shared calendars, delegated calendars, or additional personal calendars they’ve created. + +You can use the Custom Action command to make a request to the Microsoft Graph endpoint: +`/users/{user-id}/calendars` + +This allows you to fetch all calendar IDs programmatically and use them dynamically in your app.
@@ -77,7 +97,22 @@ Optional body text describing the event's agenda, context, or any additional not
-Format of the event description. Use "text" for plain text or "html" for rich content. +Specifies the formatting of the Description field. Valid values are: + +- `text`: plain text only + +- `html`: allows rich content formatting like bold text, lists, or hyperlinks + +*HTML Example:* + +```html +

Agenda:

+
    +
  • Review Q2 metrics
    • +
  • Discuss campaign rollout
    • +
  • Assign next steps
    • +
+```
@@ -85,7 +120,9 @@ Format of the event description. Use "text" for plain text or "html" for rich co
-Name of the event's physical or virtual location — such as a conference room or meeting space. +Text label for the meeting location. This can be a room, office, or virtual session name. + +
@@ -93,7 +130,13 @@ Name of the event's physical or virtual location — such as a conference room o
-Optional URL for a virtual meeting or reference link (e.g., Teams, Zoom, Google Meet). +Link to the virtual meeting location (e.g., Microsoft Teams, Zoom). + +*Example:* + +```js +https://teams.microsoft.com/l/meetup-join/19%3ameeting... +```
@@ -101,7 +144,18 @@ Optional URL for a virtual meeting or reference link (e.g., Teams, Zoom, Google
-List of attendees for the event. Each attendee should include an email and optionally their role (e.g., required, optional). +A list of participants to invite. Each attendee should be an object with at least `emailAddress`. You can also include type (e.g., required, optional). + +*Example structure:* + +```js +[ + { "emailAddress": { "address": "john@example.com" }, "type": "required" }, + { "emailAddress": { "address": "jane@example.com" }, "type": "optional" } +] +``` + +Use dynamic forms or repeaters in Appsmith to collect attendee emails and roles.
@@ -121,8 +175,24 @@ Unique identifier of the Outlook user whose calendar event is being updated. Ref
-Unique identifier of the event to be updated. -Use Microsoft Graph API’s `/users/{user-id}/calendars/{calendar-id}/events` to list events and find their Event ID. +The unique identifier of the calendar event to be updated or deleted. + +To retrieve an Event ID without using external APIs, you can: + +- Use the Custom Action command to call +`/users/{user-id}/calendars/{calendar-id}/events` + + This will return a list of events with their associated id values. You can extract the Event ID from this response and use it in update or delete operations. + +- Alternatively, if you are viewing an event in Outlook Web, the Event ID appears in the URL when you open the event details. + +
+ +```js +https://outlook.office.com/calendar/item/AAkALgAAAAAAHYQDEap... +``` +
+ @@ -138,7 +208,11 @@ Updated event title or summary.
-Updated start time in ISO 8601 format. +Defines when the event begins. This must follow ISO 8601 format, such as: + +```js +2025-04-15T10:00:00 +```
@@ -162,7 +236,7 @@ Updated end time in ISO 8601 format.
-ID of the calendar containing the event. +ID of the calendar where the event will be created. Most users have a default calendar with ID calendar, but users may have additional shared or personal calendars.
@@ -179,7 +253,11 @@ Updated event description or body content.
-Updated format of the description — either "text" or "html". +Specifies the formatting of the Description field. Valid values are: + +- `text`: plain text only + +- `html`: allows rich content formatting like bold text, lists, or hyperlinks
@@ -195,7 +273,7 @@ Updated location name for the event.
-Updated URL for virtual meeting or location reference. +Link to the virtual meeting location (e.g., Microsoft Teams, Zoom).
@@ -215,8 +293,10 @@ Retrieves detailed information for a specific calendar event in Outlook using it
-Unique identifier of the Outlook user whose calendar contains the event. -To retrieve the User ID, use the Microsoft Graph API endpoint `/users`, or access the authenticated user context. In enterprise environments, administrators can locate this in Azure Active Directory. +Unique identifier of the Outlook user whose calendar the event is created in. +This should be an email address associated with a Microsoft account, such as user@outlook.com or a work email from Microsoft 365 (e.g.,` user@company.com`). + +Gmail or other non-Microsoft domains are not supported unless linked to a Microsoft identity.
@@ -224,8 +304,23 @@ To retrieve the User ID, use the Microsoft Graph API endpoint `/users`, or acces
-Unique identifier of the event to retrieve. -To find the Event ID, use the Microsoft Graph API endpoint `/users/{user-id}/calendars/{calendar-id}/events`. Each event object returned includes an id field representing the Event ID. +The unique identifier of the calendar event to be updated or deleted. + +To retrieve an Event ID without using external APIs, you can: + +- Use the Custom Action command to call +`/users/{user-id}/calendars/{calendar-id}/events` + + This will return a list of events with their associated id values. You can extract the Event ID from this response and use it in update or delete operations. + +- Alternatively, if you are viewing an event in Outlook Web, the Event ID appears in the URL when you open the event details. + +
+ +```js +https://outlook.office.com/calendar/item/AAkALgAAAAAAHYQDEap... +``` +
@@ -255,8 +350,23 @@ Retrieve the User ID using the Microsoft Graph API `endpoint /users`, or from th
-Unique identifier of the event to be deleted. -To locate the Event ID, use the Microsoft Graph API endpoint `/users/{user-id}/calendars/{calendar-id}/events`. The id field in each event object corresponds to the Event ID. +The unique identifier of the calendar event to be updated or deleted. + +To retrieve an Event ID without using external APIs, you can: + +- Use the Custom Action command to call +`/users/{user-id}/calendars/{calendar-id}/events` + + This will return a list of events with their associated id values. You can extract the Event ID from this response and use it in update or delete operations. + +- Alternatively, if you are viewing an event in Outlook Web, the Event ID appears in the URL when you open the event details. + +
+ +```js +https://outlook.office.com/calendar/item/AAkALgAAAAAAHYQDEap... +``` +
@@ -332,17 +442,10 @@ Filters can be combined using logical operators such as and, or, etc. Specifies the maximum number of messages to return. This helps manage large datasets by retrieving only a subset of records. -*Example 1:* To fetch the 10 most recent messages in the inbox: +*Example:* To fetch the 10 most recent messages in the inbox: Set Limit Results to 10. -*Example 2:* To display a quick preview or summary (e.g., first 5 emails for a dashboard): -Set Limit Results to 5. -This value controls the top parameter in the Graph API request: - -```plaintext -?$top=5 -``` @@ -380,9 +483,9 @@ The main content of the email message. Use plain text or HTML depending on the C Specifies the format of the Message Body. Accepted values are: -- text – for plain text content +- `text` – for plain text content -- html – for rich text or HTML-formatted emails +- `html` – for rich text or HTML-formatted emails @@ -501,22 +604,5 @@ GET /users/{user-id}/calendarView?startDateTime=2025-04-01T00:00:00Z&endDateTime This returns all events between the provided dates. You can also apply filters or select specific fields using query parameters. -Example 4: Get User’s Mail Tips - Before sending an email, you want to check if recipients are out of office or if there are automatic replies configured. - -Endpoint: - -```http -POST /users/{user-id}/getMailTips -``` - -Body: - -```json -{ - "EmailAddresses": ["user@example.com"], - "MailTipsOptions": "automaticReplies" -} -``` \ No newline at end of file From eeba910af6e637d8b830080fd597e3c9dea4f05e Mon Sep 17 00:00:00 2001 From: harshilp24 Date: Thu, 17 Apr 2025 14:54:07 +0530 Subject: [PATCH 3/3] .. --- .../docs/connect-data/reference/outlook.md | 31 ++++++++++++------- 1 file changed, 20 insertions(+), 11 deletions(-) diff --git a/website/docs/connect-data/reference/outlook.md b/website/docs/connect-data/reference/outlook.md index 814ad34ddb..e9d328eb4e 100644 --- a/website/docs/connect-data/reference/outlook.md +++ b/website/docs/connect-data/reference/outlook.md @@ -167,7 +167,11 @@ Updates an existing calendar event in Outlook. Use this to modify subject, timin
-Unique identifier of the Outlook user whose calendar event is being updated. Refer to Microsoft Graph API or user context to retrieve this value. +Unique identifier of the Outlook user whose calendar the event is created in. + +This should be an email address associated with a Microsoft account, such as `user@outlook.com` or a work email from Microsoft 365 (e.g., `user@company.com`). + +Gmail or other non-Microsoft domains are not supported unless linked to a Microsoft identity.
@@ -341,8 +345,12 @@ Deletes a specific event from a user's Outlook calendar. Use this to permanently
-Unique identifier of the Outlook user whose calendar contains the event. -Retrieve the User ID using the Microsoft Graph API `endpoint /users`, or from the authenticated user context. In organizational accounts, administrators can access this via Azure Active Directory. +Unique identifier of the Outlook user whose calendar the event is created in. + +This should be an email address associated with a Microsoft account, such as `user@outlook.com` or a work email from Microsoft 365 (e.g., `user@company.com`). + +Gmail or other non-Microsoft domains are not supported unless linked to a Microsoft identity. +
@@ -387,14 +395,11 @@ Retrieves email messages from a specific folder in a user's Outlook mailbox. Use
-Unique identifier of the Outlook user whose mailbox is being accessed. -To retrieve the User ID, use Microsoft Graph API's `/users` endpoint. For personal accounts, the authenticated context typically provides the ID automatically. In enterprise accounts, administrators can obtain it from Azure Active Directory. - -Example commands to get User ID: +Unique identifier of the Outlook user whose calendar the event is created in. -- Use: `GET /users` (for organization-wide listing) +This should be an email address associated with a Microsoft account, such as `user@outlook.com` or a work email from Microsoft 365 (e.g., `user@company.com`). -- Use: `GET /me` (for authenticated user) +Gmail or other non-Microsoft domains are not supported unless linked to a Microsoft identity.
@@ -457,8 +462,12 @@ Sends an email message from a specified Outlook user. You can include recipients
-Unique identifier of the Outlook user from whose account the email is sent. -Retrieve the User ID using Microsoft Graph API’s /users endpoint, or refer to the current authenticated session via /me. For organizational accounts, the ID can also be accessed via Azure Active Directory. +Unique identifier of the Outlook user whose calendar the event is created in. + +This should be an email address associated with a Microsoft account, such as `user@outlook.com` or a work email from Microsoft 365 (e.g., `user@company.com`). + +Gmail or other non-Microsoft domains are not supported unless linked to a Microsoft identity. +