Outlook Mail Node
Outlook Node Documentation
The Outlook node provides integration with your Microsoft Outlook email account in SkyStudio workflows. You can send emails and perform advanced searches in the inbox. The connection is established using Microsoft OAuth.
Connection Setup and Management
To use the Outlook node, you must authorize it with your Microsoft account through OAuth. No API key or token entry is required; authorization is completed through Microsoft’s official sign-in screen.
Connecting to Microsoft Outlook
1. Start the Connection
- Add the Outlook node to the canvas in SkyStudio.
- Click the node to open the right panel.
- Select an operation, such as Send Mail or Search Mail.
- Click the Connect to Microsoft Outlook button at the bottom of the right panel.
2. Authorize with Your Microsoft Account
- Sign in with your corporate or personal Microsoft account on the Microsoft sign-in screen that opens.
- Approve SkyStudio’s request to access Outlook.
- Once authorization is completed, the connection becomes active in the right panel and the fields become visible.
Note: Authorization is performed through Microsoft’s standard OAuth 2.0 flow. SkyStudio does not see or store your password.
Adding the Connection to SkyStudio Alternative Method
- Go to Application Connections from the left menu in SkyStudio.
- Click the Add New Connection button.
- Select Microsoft Outlook as the provider.
- Enter a descriptive name in the Connection Name field, such as
Company Outlook. - Click the Authorize with Microsoft button and complete the Microsoft sign-in steps.
- After authorization is completed, the connection is saved automatically.
Assigning the Connection to the Node
After adding the Outlook node to the canvas, select the saved connection from the Application Connections dropdown in the right panel.
Tip: You can define separate connections for different Microsoft accounts, such as personal and corporate accounts.
Operations
The Outlook node provides 2 operations:
| Operation | Description |
|---|---|
| Send Mail | Creates and sends a new email through Outlook |
| Search Mail | Performs advanced search and filtering in the Outlook inbox |
Send Mail
Sends an email through the connected Microsoft Outlook account. It is used in notification, report sharing, and automatic response scenarios.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Outlook connection to use |
| To | Yes | Recipient email address. Separate multiple recipients with commas |
| Subject | Yes | Subject line of the email |
| Body | Yes | Email content, either plain text or HTML |
| CC | No | Email addresses to add as carbon copy |
| BCC | No | Email addresses to add as blind carbon copy |
Usage Example
To send an automatic report email from a workflow:
- To:
manager@company.com - Subject:
Weekly Sales Report - {{date}} - Body:
{{llm.output}}
Example Output
{
"id": "message-id-abc123",
"status": "sent",
"to": ["manager@company.com"],
"subject": "Weekly Sales Report"
}
Search Mail
Searches emails in the Outlook inbox using keywords, sender, or subject filters. It is used in email tracking and content extraction workflows.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Outlook connection to use |
| Search Query | Yes | Search query, such as invoice or from:ahmet@company.com |
| Folder | No | Folder to search in, such as Inbox or Sent Items |
| Limit | No | Maximum number of emails to return |
Search Query Examples
| Search Example | Description |
|---|---|
invoice | Emails that contain “invoice” in the subject or body |
from:ahmet@company.com | Emails received from a specific sender |
subject:meeting | Emails with “meeting” in the subject |
hasAttachment:true | Emails with attachments |
Example Output
{
"value": [
{
"id": "message-id-xyz",
"subject": "April Invoice Summary",
"from": {
"emailAddress": {
"address": "accounting@company.com"
}
},
"receivedDateTime": "2024-04-15T09:30:00Z",
"bodyPreview": "The invoice summary for April is attached..."
}
]
}
Quick Start Examples
Example 1: Automatic Report Email
A workflow that sends the sales report to a manager every Monday:
Schedule (Every Monday at 08:00) → HubSpot (Get Deals) → LLM (summarize) → Send Mail
Send Mail settings:
- To:
manager@company.com - Subject:
Weekly Sales Summary - Body:
{{llm.output}}
Example 2: Invoice Tracking System
A workflow that finds invoice emails in the inbox and saves them to Notion:
Schedule (Every day) → Search Mail → LLM (extract invoice information) → Create Page (Notion)
Search Mail settings:
- Search Query:
subject:invoice - Folder:
Inbox - Limit:
10
Example 3: Support Request Responder
A workflow that reads incoming support emails, generates AI responses, and sends replies:
Schedule (Every 30 minutes) → Search Mail → LLM (generate response) → Send Mail
Search Mail settings:
- Search Query:
subject:support - Folder:
Inbox - Limit:
5
Send Mail settings:
- To:
{{mail.from}} - Subject:
Re: {{mail.subject}} - Body:
{{llm.output}}
Example 4: Sending Form Results by Email
A workflow that sends a form submitted by the user to the relevant department by email:
Form Builder → LLM (summarize form) → Send Mail
Send Mail settings:
- To:
hr@company.com - Subject:
New Application: {{form.name}} - Body:
{{llm.output}}
Common Errors
| Error | Possible Cause | Solution |
|---|---|---|
Microsoft Outlook Connection Required | OAuth authorization has not been completed | Click the Connect to Microsoft Outlook button in the node panel and sign in |
401 Unauthorized | OAuth token has expired | Refresh the connection from the Application Connections page and authorize again |
403 Forbidden | The account does not have permission to send emails | Check with the Microsoft 365 administrator that the required permissions have been granted |
Email cannot be sent | Recipient address is invalid | Check that the email address in the To field is in the correct format |
| Empty search result | The search query did not match any emails | Check the Search Query value and Folder selection |
Notes
- The Outlook node is authorized using Microsoft OAuth 2.0; no password or API key is required.
- The OAuth token is automatically refreshed at certain intervals. Connections that have not been used for a long time may require reauthorization.
- HTML content can be entered in the Body field of the Send Mail operation, allowing formatted emails to be sent.
- The Search Mail operation scans only the folders accessible by the connected account. Access to shared mailboxes may require permission from the Microsoft 365 administrator.
- In corporate Microsoft 365 accounts, IT policies may restrict third-party application connections. If you experience issues, contact your IT department.