Skip to main content
Let’s learn how to connect Engini to Outlook. Use Outlook in your workflows to send and read emails, work with drafts and attachments, and manage calendar events. To get started, create an account at Outlook, or use your organization’s Microsoft 365 mailbox.

Add a Connection to Outlook in Engini

Prerequisites

  • An Outlook account: a free Outlook.com account or a Microsoft 365 mailbox.

Connecting Engini to Outlook

  1. Enter your Engini account at https://app.engini.io.
  2. Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here. Engini - Connections page
  3. Click on the “New Integration” option located at the top bar. Engini - New Integration button
  4. Choose the Outlook option from the available applications. Outlook - Choose Application
  5. Fill in the “New Integration” form and press Save: Note: There are two different authentication methods available, and the required fields differ depending on the option you choose. Please follow the relevant instructions based on your selected method.

OAuth2

This is the default method. You sign in with your Microsoft account, so you don’t need to provide a Client Id or Client Secret. Outlook - New Integration form, OAuth2
  1. Connection Name - Enter a name that helps identify the Outlook connection.
  2. Authentication Method - Select OAuth2.
  3. Sign in with Microsoft - Click Sign in with Microsoft and sign in to your Microsoft account.
  4. Save - Click Save to create the connection.

Custom OAuth 2.0

Choose this method if you want Engini to connect through an app that you registered yourself in Microsoft Azure, instead of the default Microsoft sign-in. Create the app registration first, in the Azure portal, with these settings:
  • Supported account types: multitenant and personal Microsoft accounts.
  • Redirect URI: add a Web platform redirect URI, exactly https://workflowapi.engini.io/api/auth/OAuthRedirectUrl (the same address the Callback URL field below shows).
  • API permissions: add these delegated Microsoft Graph permissions: User.Read, User.Read.All, Mail.Send, Mail.Read, Mail.ReadWrite.Shared, Mail.Read.Shared, Mail.Send.Shared, Calendars.Read.Shared, Calendars.ReadWrite.Shared and offline_access.
  • Client secret: create a client secret and copy its Value (not the Secret ID).
Then enter these details in the form: Outlook - New Integration form, Custom OAuth 2.0
  1. Connection Name - Enter a name that helps identify the Outlook connection.
  2. Authentication Method - Select Custom OAuth 2.0.
  3. Callback URL - A read-only field that shows the address Microsoft sends you back to after you sign in (https://workflowapi.engini.io/api/auth/OAuthRedirectUrl). Click the copy button next to it, then add this address as a Web redirect URI in the Azure app registration. Do this before you enter the Client Id and Client Secret, so that the sign-in works.
  4. Client Id - The Application (client) ID of your Azure app registration.
  5. Client Secret - The client secret Value created for your Azure app registration.
  6. Signin - Click Signin and sign in to your Microsoft account.
  7. Save - Click Save to create the connection.

Triggers

Check for new emails

Starts the workflow when a new email arrives in the mailbox you choose. Engini checks the mailbox on the schedule you set. Outlook - Check for new emails trigger
  1. Mailbox - The mailbox to check. The default is me, the mailbox of the connected account. To watch a shared mailbox instead, see Watch a shared mailbox or shared folder below.
  2. Starting (UTC) - Select the start date and time for the scheduled trigger.
  3. Recur every - Choose the time interval for triggering and checking emails. The minimum time interval is 15 minutes.
  4. Add time frame - You can specify a time frame during which the trigger will operate.
  5. Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
Include Attachments: this is one of the filter options. Set it to Yes to receive the email’s attachments in the output. When it is No, or not set, the Attachments list in the output is empty. Folder: another filter option. Enter the folder to check, for example Inbox. When Mailbox holds a shared mailbox, this is the folder of that shared mailbox that Engini watches for new emails. Flag Status: another filter option. Choose Flagged, Complete or Not flagged to receive only emails with that follow-up flag status. Watch a shared mailbox or shared folder: there is no separate trigger for this - use Check for new emails as follows.
  • Set Mailbox to the email address of the shared mailbox, for example shared@company.com.
  • Click Add Filter, add the Folder filter and enter the folder to watch, for example Inbox.
  • The account of your Outlook connection must have access to that shared mailbox (the Mail.Read.Shared permission); otherwise Outlook does not return its emails.
Each new email is passed to the next steps with these properties:
  • Message Id - The unique identifier of the email. Use it in later steps, for example in Get Email or Reply Comment To a Message.
  • From - The email address the email was sent from.
  • To - The email addresses the email was sent to.
  • CC - The email addresses in the CC field.
  • Subject - The subject of the email.
  • Body - The full content of the email.
  • Body Preview - A short text preview of the email body.
  • Recieved DateTime - The date and time the email was received.
  • Importance - The importance set on the email.
  • Web Link - A link that opens the email in Outlook on the web.
  • Attachments - The files attached to the email. It is filled only when Include Attachments is Yes; otherwise the list is empty. Each attachment has:
    • Id - The Id of the attachment in Outlook. Use it to refer to this exact file in a later step.
    • File Name - The name of the file.
    • Size - The size of the file.
    • Content Type - The type of the file, for example application/pdf.
    • Content - The content of the file.

Check for new or updated events

Watches a calendar for new or updated events, running on the schedule you set. Outlook - Check for new or updated events trigger
  1. Calendar - The Id of the calendar to watch.
  2. Starting (UTC) - Select the start date and time for the scheduled trigger.
  3. Recur every - Choose the time interval for triggering and checking the calendar. The minimum time interval is 15 minutes.
  4. Add time frame - You can specify a time frame during which the trigger will operate.
Each new or updated event is passed to the next steps with these properties:
  • Id - The unique identifier of the event. Use it in later steps, for example in Get Event or Update Event.
  • Subject - The title of the event.
  • Body Preview - A short text preview of the event description.
  • Importance - The importance set on the event.
  • Is All Day - Whether the event lasts all day.
  • Is Cancelled - Whether the event was cancelled.
  • Is Organizer - Whether you are the organizer of the event.
  • Is Online Meeting - Whether the event is an online meeting.
  • Online Meeting Url - The link to join the online meeting.
  • Show As - How the event appears in your calendar, for example busy or free.
  • Has Attachments - Whether the event has attached files.
  • Type - The kind of event, for example a single event or an occurrence of a recurring series.
  • Series Master Id - For an occurrence of a recurring event, the Id of the series it belongs to.
  • Web Link - A link that opens the event in Outlook on the web.
  • Created Date Time - The date and time the event was created.
  • Last Modified Date Time - The date and time the event was last changed.
  • Start - When the event starts:
    • Date Time - The date and time the event starts.
    • Time Zone - The time zone of the start date and time.
  • End - When the event ends:
    • Date Time - The date and time the event ends.
    • Time Zone - The time zone of the end date and time.
  • Location - Where the event takes place:
    • Display Name - The name of the place, as shown in the event.
  • Organizer - The person who organized the event:
    • Name - The organizer’s name.
    • Address - The organizer’s email address.
  • Attendees - The people invited to the event. Each attendee has:
    • Type - Whether the attendee is required, optional or a resource.
    • Name - The attendee’s name.
    • Address - The attendee’s email address.
    • Response - The attendee’s answer to the invitation, for example accepted or declined.
    • Time - The date and time the attendee responded.

Check for new or updated contacts

Starts the workflow when a contact in your Outlook mailbox is created or changed. Engini checks your contacts on the schedule you set. Outlook - Check for new or updated contacts trigger
  1. Starting (UTC) - Select the start date and time for the scheduled trigger.
  2. Recur every - Choose the time interval for triggering and checking contacts. The minimum time interval is 15 minutes.
  3. Add time frame - You can specify a time frame during which the trigger will operate.
Each run looks at the contacts that were created or changed in the last hour, so set Recur every to 1 hour or less. A schedule longer than 1 hour can miss changes made between runs. A contact can also be delivered more than once, because two runs in a row can both pick it up within that hour. To avoid handling it twice, compare its Id and Last Modified with the ones you already processed. Each contact is passed to the next steps with these properties:
  • Id - The unique identifier of the contact. Use it in later steps, for example in Get Contact or Update Contact.
  • Created - The date and time the contact was created.
  • Last Modified - The date and time the contact was last changed.
  • Change Key - The version of the contact.
  • Parent Folder Id - The identifier of the folder that holds the contact.
  • Display Name - The name shown in the contact list.
  • First Name - The contact’s first name.
  • Last Name - The contact’s last name.
  • Job Title - The contact’s role at the company.
  • Company - The company the contact works for.
  • Department - The contact’s department.
  • Mobile Phone - The contact’s mobile phone number.
  • Business Phones - The contact’s work phone numbers.

Check for upcoming events

Starts the workflow when an event in your calendar is about to start. Engini checks your calendar on the schedule you set. Outlook - Check for upcoming events trigger
  1. Minutes Before Start - Enter how many minutes ahead to look. Events that start within this many minutes are passed to the next steps. The default is 15.
  2. Starting (UTC) - Select the date on which the schedule begins, and in At the time of day, in UTC.
  3. Recur every - Enter a number and choose a time unit, for example 15 and Minute, to set how often Engini checks your calendar for upcoming events. The minimum time interval is 15 minutes.
  4. Add time frame - You can specify a time frame during which the trigger will operate.
Under the fields, Next Run at shows when the trigger will run next. This trigger has no Add Filter option. Each run looks at the events that start between the moment the run starts and Minutes Before Start minutes after it. Because the next run looks at a new window starting from its own start time, set Recur every to the same number of minutes as Minutes Before Start (for example 15 and 15) so no start time is skipped. If Recur every is shorter than Minutes Before Start, the windows overlap and the same event can be delivered on more than one run; to avoid handling it twice, compare its Id with the ones you already processed. Each event is passed to the next steps with these properties:
  • Id - The unique identifier of the event. Use it in later steps, for example in Get Event or Update Event.
  • Subject - The title of the event.
  • Body Preview - A short text preview of the event description.
  • Importance - The importance set on the event.
  • Is All Day - Whether the event lasts all day.
  • Is Cancelled - Whether the event was cancelled.
  • Is Organizer - Whether you are the organizer of the event.
  • Is Online Meeting - Whether the event is an online meeting.
  • Online Meeting Url - The link to join the online meeting.
  • Show As - How the event appears in your calendar, for example busy or free.
  • Has Attachments - Whether the event has attached files.
  • Type - The kind of event, for example a single event or an occurrence of a recurring series.
  • Series Master Id - For an occurrence of a recurring event, the Id of the series it belongs to.
  • Web Link - A link that opens the event in Outlook on the web.
  • Created Date Time - The date and time the event was created.
  • Last Modified Date Time - The date and time the event was last changed.
  • Start - When the event starts:
    • Date Time - The date and time the event starts.
    • Time Zone - The time zone of the start date and time.
  • End - When the event ends:
    • Date Time - The date and time the event ends.
    • Time Zone - The time zone of the end date and time.
  • Location - Where the event takes place:
    • Display Name - The name of the place, as shown in the event.
  • Organizer - The person who organized the event:
    • Name - The organizer’s name.
    • Address - The organizer’s email address.
  • Attendees - The people invited to the event. Each attendee has:
    • Type - Whether the attendee is required, optional or a resource.
    • Name - The attendee’s name.
    • Address - The attendee’s email address.
    • Response - The attendee’s answer to the invitation, for example accepted or declined.
    • Time - The date and time the attendee responded.

Actions

Add Attachment to Draft Email

Adds a file to an email that is saved in your Drafts folder. The email is not sent. Outlook - Add Attachment to Draft Email action
  1. Draft Email Id - The unique identifier of the draft email. Map it from a previous Create Draft Message step.
  2. File Name - The name of the file, including its extension, for example invoice.pdf.
  3. Content - The content of the file as Base64 text. The file can be up to 3 MB.

Add attachment to existing event

Adds a file to an event that already exists in a calendar. Outlook - Add attachment to existing event action
  1. Calendar Id - The unique identifier of the calendar that contains the event.
  2. Event Id - The unique identifier of the event you want to add the file to.
  3. File name - The name of the file, including its extension, for example agenda.pdf.
  4. Content - The content of the file as Base64 text.

Copy Message

Copies an email into another folder. The original email stays where it is. Outlook - Copy Message action
  1. Message Id - The unique identifier of the email you want to copy.
  2. Destination Folder - The folder to copy the email to. Enter a well-known folder name such as inbox or archive, or the unique identifier of a folder.

Create Calendar

Creates a new calendar in your Outlook account. Outlook - Create Calendar action
  • Name - The name of the new calendar, for example Project Planning.

Create Child Mail Folder

Creates a new folder inside an existing folder. Outlook - Create Child Mail Folder action
  1. Parent Folder - The folder to create the new folder in. Enter a well-known folder name such as inbox, or the unique identifier of a folder.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Both of the following are added through Add Field:
  • Folder Name - The name of the new folder.
  • Hidden - Whether the folder is hidden. Choose Yes or No.

Create Contact

Creates a contact in your Outlook mailbox. Outlook - Create Contact action
  • Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • First Name - The contact’s first name.
  • Last Name - The contact’s last name.
  • Display Name - The name shown in the contact list.
  • Email Addresses - The contact’s email addresses. Add one item per address and fill its Email (for example name@example.com) and Name (the name shown for this address), or switch the field to raw input with the code icon and map a whole list from an earlier step.
  • Business Phones - The contact’s work phone numbers, one entry per number.
  • Mobile Phone - The contact’s mobile phone number, with the country code, for example +1 555 0100.
  • Job Title - The contact’s role at the company.
  • Company - The company the contact works for.
  • Department - The contact’s department at the company.
Note: List fields hold a list with one entry per item.

Create Draft Message

Creates an email in your Drafts folder without sending it. Outlook - Create Draft Message action
  1. Subject - The subject line of the email.
  2. Body - The content of the email. You can write plain text or HTML, for example <p>Hello <b>Anna</b></p>.
  3. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • To Recipients - The people the email is addressed to. Each item is an Email Address group that holds an Email Address (required, placeholder name@example.com) and a Name (placeholder Name shown to the recipient).
  • Cc Recipients - The people to copy on the email. Each item is filled in like an item of To Recipients.
  • Reply To - The addresses replies should go to. Each item is filled in like an item of To Recipients.
  • Attachments - The files attached to the email. Each item has a File Name (with the extension, for example report.pdf), an Attachment Type (leave it as is for a normal file) and Content (the file content as Base64 text).
  • Internet Message Headers - Additional internet message headers. Each item has a Name (a header name that starts with x-, for example x-order-number) and a Value.
How to fill a list field: a list field holds several items, and you have two ways to fill it:
  • Add items one by one - Click the add button below the list. Each item opens its own fields (for a recipient, an Email Address group with Email Address and Name). Click the add button again for every further entry, and use the trash icon to remove one.
  • Map a whole list - Switch the field to raw input with the code icon, then map a list that an earlier step produced, for example one built with Initialize Object Array and Append to Object Array. Use the list icon to switch back to the item fields.

Create Draft Reply

Creates a draft reply to an email. The reply is saved in your Drafts folder and is not sent. Outlook - Create Draft Reply action
  1. Message Id - The unique identifier of the email you want to reply to.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Optional, added through Add Field:
  • Comment - The text of your reply.

Create Draft Reply All

Creates a draft reply to the sender and all recipients of an email. The reply is saved in your Drafts folder and is not sent. Outlook - Create Draft Reply All action
  1. Message Id - The unique identifier of the email you want to reply to.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Optional, added through Add Field:
  • Comment - The text of your reply.

Create Event

Creates an event in a calendar. Outlook - Create Event action
  1. Mailbox - The mailbox that owns the calendar. The default is me, the mailbox of the connected account. To use a shared mailbox, enter its email address.
  2. Calendar Id - The unique identifier of the calendar to add the event to. To use your default calendar, enter calendar.
  3. Subject - The title of the event.
  4. Start time - The start date and time of the event, written like 2026-10-31T14:00:00, without a time zone. Set the time zone in Time Zone.
  5. End time - The end date and time of the event, written like 2026-10-31T15:00:00, without a time zone.
  6. Time Zone - The time zone of the start and end times. Pick one from the list or type a time zone name.
  7. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • Body - The description of the event. You can write plain text or HTML.
  • Location - Where the event takes place.
  • Required attendees - The attendees who must attend, as email addresses separated by commas, for example anna@example.com, ben@example.com.
  • Optional attendees - The attendees who are invited but not required, as email addresses separated by commas.
  • Categories - The Outlook categories assigned to the event, as category names separated by commas.
  • Importance - The importance of the event.
  • Sensitivity - The sensitivity of the event.
  • Show As - How the event shows in your calendar, for example Busy or Free.
  • Reminder Minutes Before Start - How many minutes before the start the reminder appears, as a whole number, for example 15.
  • Is Reminder On? - Whether a reminder is set.
  • Is All Day? - Whether the event lasts all day.
  • Response Requested? - Whether attendees are asked to respond.
  • Is Online Meeting? - Whether the event is an online meeting.
  • Allow New Time Proposals - Whether attendees can propose a new time.
  • Is Draft? - Whether the event is a draft.
  • Hide Attendees? - Whether attendees are hidden from each other.

Create Mail Folder

Creates a new folder at the top level of the mailbox. Outlook - Create Mail Folder action
  • Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Both of the following are added through Add Field:
  • Folder Name - The name of the new folder.
  • Hidden - Whether the folder is hidden. Choose Yes or No.

Delete Contact

Deletes a contact from your Outlook mailbox. Outlook - Delete Contact action
  • Contact Id - The unique identifier of the contact you want to delete.

Delete Event

Deletes an event from a calendar. Outlook - Delete Event action
  1. Calendar Id - The unique identifier of the calendar that contains the event. To use your default calendar, enter calendar.
  2. Event Id - The unique identifier of the event you want to delete.
Note: Running the action again for an event that was already deleted returns an error.

Delete Message

Moves an email to the Deleted Items folder. The email can be recovered from there until the folder is emptied. Outlook - Delete Message action
  • Message Id - The unique identifier of the email you want to delete.

Download Attachment

Retrieves the file attached to an email. Outlook - Download Attachment action
  1. Message Id - The unique identifier of the email that has the attachment.
  2. Attachment Id - The unique identifier of the attachment you want to download.

Forward Message

Forwards an existing email to new recipients. Outlook - Forward Message action
  1. Message Id - The unique identifier of the email you want to forward.
  2. Comment - A note to add above the forwarded email.
  3. To Recipients - The people the email is forwarded to. This field holds a list: add one item per person. Each item is an Email Address group that holds an Email Address (required, placeholder name@example.com) and a Name (placeholder Name shown to the recipient). Or switch the field to raw input with the code icon and map a whole list of recipients from an earlier step.

Get Attachment

Retrieves the content and properties of one attachment of an email. Outlook - Get Attachment action
  1. Message Id - The unique identifier of the email that has the attachment.
  2. Attachment Id - The unique identifier of the attachment you want to retrieve.
Note: The file content is returned as a Base64 string in Content Bytes.

Get Attachments

Retrieves the list of attachments of an email. Outlook - Get Attachments action
  1. Message Id - The unique identifier of the email that has the attachments.
  2. Top N - You can set the maximum number of records Engini will return for the object you chose (default = all records).
  3. Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Get Calendar

Retrieves the details of one of your calendars, such as its name and color. Outlook - Get Calendar action
  • Calendar Id - The calendar to retrieve. You have 3 ways to fill it:
    • Dynamic List - Choose through a live, auto-generated list of your Outlook calendars.
    • Dynamic Mapping - Map the Id returned by a previous Get Calendars step so it changes automatically based on real-time data.
    • Static Text - Provide the identifier of a calendar.

Get Calendars

Retrieves the list of your Outlook calendars. Outlook - Get Calendars action Note: The panel for this action does not show any input fields. Use its results, for example a calendar Id, in later steps such as Get Events or Get Calendar.

Get Contact

Retrieves the details of a single contact, such as the name, company and phone numbers. Outlook - Get Contact action
  • Contact Id - The unique identifier of the contact you want to retrieve. Map it from a previous step, for example the Id of the Check for new or updated contacts trigger or of a Get Contacts step.

Get Contacts

Retrieves the contacts in your Outlook mailbox. Outlook - Get Contacts action
  • Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The following field is optional and is added through Add Field:
  • Email Address - Enter an email address to return only the contacts that have this email address. Leave it empty to return all your contacts. If no contact has the address, the result is an empty list.

Get Email

Retrieves the details of a single email, such as its sender, recipients and body. Outlook - Get Email action
  • Email Id - The unique identifier of the email you want to retrieve. Map it from a previous step, for example the Message Id of the Check for new emails trigger.

Get Event

Retrieves the details of a single calendar event, such as its subject and times. Outlook - Get Event action
  • Event Id - The unique identifier of the event you want to retrieve. Map it from a previous step, for example an Id returned by Get Events.

Get Event Instances

Retrieves the occurrences of a recurring event within a date range. Outlook - Get Event Instances action
  1. Event Id - The unique identifier of the first event of a recurring series. Map it from a previous step, for example Get Events.
  2. Start Date - The start of the date range, for example 2026-10-01T00:00:00Z.
  3. End Date - The end of the date range, for example 2026-10-31T00:00:00Z.
Note: Use the first event of the series. Entering the Id of a single event that doesn’t repeat returns an error.

Get Events

Retrieves the events of one of your calendars. Outlook - Get Events action
  1. Calendar Id - The calendar to read the events from. You have 3 ways to fill it:
    • Dynamic List - Choose through a live, auto-generated list of your Outlook calendars.
    • Dynamic Mapping - Map the Id returned by a previous Get Calendars step so it changes automatically based on real-time data.
    • Static Text - Provide the identifier of a calendar.
  2. Filter - Enter an OData condition to return only the events that match it, for example isAllDay eq true. Leave it empty to return all the events of the calendar.

Get Group Events

Retrieves the events of a group calendar. Outlook - Get Group Events action
  1. Group Id - The unique identifier of the group whose events you want to read. It needs a work account connected through Custom OAuth 2.0.
  2. Filter - Enter an OData condition to return only the events that match it, for example isAllDay eq true. Leave it empty to return all the events of the group.

Get Messages

Retrieves a list of emails from a mailbox folder. Outlook - Get Messages action
  1. Mailbox - The mailbox to read the emails from.
  2. Mail Folder Id - The unique identifier of the folder to read the emails from.
  3. Top N - You can set the maximum number of records Engini will return for the object you chose (default = all records).
  4. Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Get Schedule

Retrieves the availability information of a calendar. Outlook - Get Schedule action Note: The panel for this action does not show any input fields at the moment.

Move Message

Moves an email to another folder in the mailbox. Outlook - Move Message action
  1. Message Id - The unique identifier of the email you want to move.
  2. Destination Id - The unique identifier of the folder you want to move the email to.

Permanent Delete

Deletes an email completely, without moving it to Deleted Items. The email can’t be recovered. Outlook - Permanent Delete action
  1. Mailbox - The mailbox that contains the email. If you leave it empty, your own mailbox is used.
  2. Message Id - The unique identifier of the email you want to delete.

Reply Comment To a Message

Replies to an email with the comment you write. Outlook - Reply Comment To a Message action
  1. Message Id - The unique identifier of the email you want to reply to.
  2. Comment - The text of your reply. You can write plain text or HTML.

Send Draft Message

Sends an email that is already saved in your Drafts folder. Outlook - Send Draft Message action
  • Message Id - The unique identifier of the draft email. Map it from a previous Create Draft Message step.
Note: You can’t send a draft that doesn’t exist yet. Create it first with Create Draft Message.

Send Email

Sends an email from your Outlook mailbox. Outlook - Send Email action
  1. From mailbox - The mailbox to send the email from. Leave it empty to send from the mailbox of the connected account, or enter the email address of a shared mailbox.
  2. To - The recipients’ email addresses, separated by commas (semicolons also work), for example anna@example.com, ben@example.com.
  3. Subject - The subject line of the email.
  4. Body - The content of the email. You can write plain text or HTML, for example <p>Hello <b>Anna</b></p>.
  5. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • CC - Email addresses to copy on the email, separated by commas, for example team@example.com, boss@example.com.
  • BCC - Email addresses to copy on the email without showing them to the other recipients, separated by commas.
  • Attachments - The files attached to the email. Add one item per file and fill its File Name (with the extension, for example invoice.pdf), Attachment Type and Content (the file content as Base64 text). To attach a list of files you built earlier, switch the field to raw input and map the list, for example one created with Initialize attachment array and Append to attachments array.

Send MIME Message

Sends an email you have already built as a complete MIME message, for example a message that is digitally signed (S/MIME) or that carries attachments. The whole message is passed to Outlook as one Base64-encoded text. Outlook - Send MIME Message action
  1. From mailbox - The mailbox to send the message from. The default is me (Current connection), your own mailbox. To send from a shared mailbox instead, choose it from the list.
  2. Message (MIME) - The whole email as a Base64-encoded MIME message. It can carry the sender, the recipients, the subject, the body, S/MIME signing and attachments. Map it from an earlier step, for example a step that builds or reads the message file.

Update Contact

Changes the details of an existing contact. Outlook - Update Contact action
  1. Contact Id - The unique identifier of the contact you want to update. Map it from a previous step, for example a Get Contacts step.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • First Name - The contact’s first name.
  • Last Name - The contact’s last name.
  • Display Name - The name shown in the contact list.
  • Email Addresses - The contact’s email addresses. Add one item per address and fill its Email (for example name@example.com) and Name (the name shown for this address), or switch the field to raw input with the code icon and map a whole list from an earlier step.
  • Business Phones - The contact’s work phone numbers, one entry per number.
  • Mobile Phone - The contact’s mobile phone number, with the country code, for example +1 555 0100.
  • Job Title - The contact’s role at the company.
  • Company - The company the contact works for.
  • Department - The contact’s department at the company.
Note: List fields hold a list with one entry per item.

Update Event

Changes an existing event in a calendar. Outlook - Update Event action
  1. Mailbox - The mailbox that owns the calendar. The default is me, the mailbox of the connected account. To use a shared mailbox, enter its email address.
  2. Calendar Id - The unique identifier of the calendar that contains the event.
  3. Event Id - The unique identifier of the event you want to update.
  4. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • Subject - The title of the event.
  • Start time - The new start date and time of the event, written like 2026-10-31T14:00:00, without a time zone. Set the time zone in Time Zone.
  • End time - The new end date and time of the event, written like 2026-10-31T15:00:00, without a time zone.
  • Time Zone - The time zone of the start and end times. Pick one from the list or type a time zone name.
  • Body - The description of the event. You can write plain text or HTML.
  • Location - Where the event takes place.
  • Required attendees - The attendees who must attend, as email addresses separated by commas, for example anna@example.com, ben@example.com.
  • Optional attendees - The attendees who are invited but not required, as email addresses separated by commas.
  • Categories - The Outlook categories assigned to the event, as category names separated by commas.
  • Importance - The importance of the event.
  • Sensitivity - The sensitivity of the event.
  • Show As - How the event shows in your calendar, for example Busy or Free.
  • Reminder Minutes Before Start - How many minutes before the start the reminder appears, as a whole number, for example 15.
  • Is Reminder On? - Whether a reminder is set.
  • Is All Day? - Whether the event lasts all day.
  • Response Requested? - Whether attendees are asked to respond.
  • Is Online Meeting? - Whether the event is an online meeting.
  • Allow New Time Proposals - Whether attendees can propose a new time.
  • Is Draft? - Whether the event is a draft.
  • Hide Attendees? - Whether attendees are hidden from each other.

Update Message

Changes an existing email, for example a draft before you send it. Outlook - Update Message action
  1. Message Id - The unique identifier of the email you want to update.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • Subject - The new subject line of the email.
  • Body - The new content of the email. You can write plain text or HTML.
  • To Recipients - The people the email is addressed to. Each item is an Email Address group that holds an Email Address (required, placeholder name@example.com) and a Name (placeholder Name shown to the recipient).
  • Cc Recipients - The people to copy on the email. Each item is filled in like an item of To Recipients.
  • BCC Recipients - The people to copy on the email without showing them to the other recipients. Each item is filled in like an item of To Recipients.
  • Reply To - The addresses replies should go to. Each item is filled in like an item of To Recipients.
  • Categories - The Outlook categories assigned to the email, as a list of category names.
  • Importance - The importance of the email: Low, normal or high.
  • Is Read - Whether the email is marked as read.
  • Is Delivery Receipt Requested - Whether a delivery receipt is requested.
  • Is Read Receipt Requested - Whether a read receipt is requested.
  • Inference Classification - Whether Outlook ranks the email as Focused or Other.
  • Internet Message Id - The message Id from the email’s internet headers.
  • Flag Status - The follow-up flag status of the email: notFlagged, flagged or complete.
  • Flag Date Time - The date and time of the follow-up flag, written like 2026-10-31T14:00:00, without a time zone. Set the time zone in Flag Time Zone.
  • Flag Time Zone - The time zone of the follow-up flag date and time, as a time zone name, for example UTC.
How to fill a list field: a list field holds several items, and you have two ways to fill it:
  • Add items one by one - Click the add button below the list. Each item opens its own fields (for a recipient, an Email Address group with Email Address and Name). Click the add button again for every further entry, and use the trash icon to remove one.
  • Map a whole list - Switch the field to raw input with the code icon, then map a list that an earlier step produced, for example one built with Initialize Object Array and Append to Object Array. Use the list icon to switch back to the item fields.

Initialize attachment array

Creates a list variable that holds files, so you can collect several files in one place. Outlook - Initialize attachment array action
  • Name - The name of the list. Use this name when you add files to it with Append to attachments array.

Append to attachments array

Adds a file to a list created with Initialize attachment array. Outlook - Append to attachments array action
  1. Variable - Select the list you want to add the file to. The list must already be initialized.
  2. File name - The name of the file, including its extension.
  3. Content - The content of the file as Base64 text.

Initialize Object Array

Creates a new object array variable in your workflow to store structured Outlook data for use in later steps. Outlook - Initialize Object Array action
  1. Variable name - Enter the name of the variable that will hold the object array. This name will be used throughout the workflow whenever you refer to this object array.
  2. Object Element Type - Select the type of object the array will store. The selected type determines the structure of the array and opens its fields so you can fill in the values for the first entry.

Append to Object Array

Adds a new entry to an existing object array variable in your workflow. Outlook - Append to Object Array action
  • Variable - Select the object array variable you want to append to. This must be an already initialized object array.

Map Object Array

Transforms a list of data into a structured object array that can be used later in the workflow. It iterates over each item in the selected data list and maps it into a structured entry. Outlook - Map Object Array action
  1. Data List - Select or map the array or list of data you want to iterate over and transform.
  2. Object name - Select, from the list, the object that each item is mapped into.

Send API Request

This activity allows you to send a custom API request directly to Outlook’s API. Outlook - Send API Request action
  1. Base Url - The root URL of the Outlook API. It is filled in from your Outlook connection and can’t be edited here.
  2. Relative url - You can specify additional path segments or parameters that need to be added to the end of the Base Url. This allows you to customize the specific request you want to perform.
  3. Method - Select the HTTP method (e.g., Get, Post, Put, Delete, Patch). The default is POST.
  4. Body Type - Defines the format of the data in the body of your request. The default, application/json, means the body contains a JSON-formatted payload.
    • application/json – Sends the request body in JSON format. Commonly used by REST APIs.
    • Custom (use Content-Type header) – Allows you to define a custom body format by manually setting the Content-Type header. Add a Content-Type row in Add Headers with the media type you need (for example application/xml). With any other Body Type, a Content-Type you type in Add Headers is not sent; Engini sets it from the Body Type.
    • application/x-www-form-urlencoded – Sends the body as URL-encoded key-value pairs, commonly used in form submissions.
    • file – Sends a file as the request body.
    • multipart/form-data – Sends form data that may include both text fields and files.
    • text/html – Sends the request body as HTML content.
    • text/plain – Sends the request body as plain text.
    • text/xml – Sends the request body in XML format.
  5. Body - Contains any data that is being sent to the server.
  6. Add Headers - Additional metadata about the request, such as the type of data Engini can accept, the length of the request body, and authentication information.
  7. Add Queries - The query refers to the parameters or data that are included in the URL of an HTTP request to provide additional information or instructions to the server.
For the full list of endpoints, see the Microsoft Graph API reference.