Outlook

Connect to Microsoft Outlook. Manage emails, calendar events, contacts, and tasks

Supports authentication: OAuth 2.0

Set up the agent connector

Register your Scalekit environment with the Outlook connector so Scalekit handles the authentication flow and token lifecycle for you. The connection name you create will be used to identify and invoke the connection programmatically. Then complete the configuration in your application as follows:

1. Create the Outlook connection in Scalekit

   • In Scalekit dashboard, go to Agent Actions → Connections and click + Create Connection. Search for Outlook and click Create.

     

   • In the Configure Outlook Connection dialog, copy the Redirect URI. You will need this when registering your app in Azure.

     

2. Register an application in Azure

   • Sign into portal.azure.com and go to Microsoft Entra ID → App registrations.

     

   • Click New registration. Enter a name for your app (for example, “Scalekit Outlook Connector”).

   • Under Supported account types, select Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts.

   • Under Redirect URI, select Web and paste the redirect URI you copied from the Scalekit dashboard. Click Register.

     

3. Get your client credentials

   • From the app’s Overview page, copy the Application (client) ID.

     

   • Go to Certificates & secrets in the left sidebar, then click + New client secret.

     

   • Enter a description (for example, “Secret for Scalekit Agent Actions”), set an expiry period, and click Add. Copy the secret Value immediately — it is only shown once.

     

4. Add credentials in Scalekit

   • In Scalekit dashboard, go to Agent Actions → Connections and open the Outlook connection you created.

   • Enter your credentials:

     • Client ID — the Application (client) ID from the Azure app overview
     • Client Secret — the secret value from Certificates & secrets
     • Scopes — select the permissions your app needs (for example, Calendars.Read, Calendars.ReadWrite, Mail.Read, Mail.ReadWrite, Mail.Send, Contacts.Read, Contacts.ReadWrite, User.Read, offline_access). See Microsoft Graph permissions reference for the full list.

   • Click Save.

Usage

Connect a user’s Outlook account and make API calls on their behalf — Scalekit handles OAuth and token management automatically.

You can interact with Outlook in two ways — via direct proxy API calls or via Scalekit optimized tool calls. Scroll down to see the list of available Scalekit tools.

Proxy API Calls

Node.js

import { ScalekitClient } from '@scalekit-sdk/node';
import 'dotenv/config';

const connectionName = 'outlook'; // get your connection name from connection configurations
const identifier = 'user_123';  // your unique user identifier

// Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
const scalekit = new ScalekitClient(
  process.env.SCALEKIT_ENV_URL,
  process.env.SCALEKIT_CLIENT_ID,
  process.env.SCALEKIT_CLIENT_SECRET
);
const actions = scalekit.actions;

// Authenticate the user
const { link } = await actions.getAuthorizationLink({
  connectionName,
  identifier,
});
console.log('🔗 Authorize Outlook:', link);
process.stdout.write('Press Enter after authorizing...');
await new Promise(r => process.stdin.once('data', r));

// Make a request via Scalekit proxy
const result = await actions.request({
  connectionName,
  identifier,
  path: '/v1.0/me/messages',
  method: 'GET',
});
console.log(result);

Python

import scalekit.client, os
from dotenv import load_dotenv
load_dotenv()

connection_name = "outlook"  # get your connection name from connection configurations
identifier = "user_123"     # your unique user identifier

# Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
scalekit_client = scalekit.client.ScalekitClient(
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
    env_url=os.getenv("SCALEKIT_ENV_URL"),
)
actions = scalekit_client.actions

# Authenticate the user
link_response = actions.get_authorization_link(
    connection_name=connection_name,
    identifier=identifier
)
# present this link to your user for authorization, or click it yourself for testing
print("🔗 Authorize Outlook:", link_response.link)
input("Press Enter after authorizing...")

# Make a request via Scalekit proxy
result = actions.request(
    connection_name=connection_name,
    identifier=identifier,
    path="/v1.0/me/messages",
    method="GET"
)
print(result)

Scalekit Tools

Tool list

outlook_create_calendar_event

Create a new calendar event in the user’s Outlook calendar. Supports attendees, recurrence, reminders, online meetings, multiple locations, and event properties.

Name	Type	Required	Description
attendees_optional	string	No	Array of email addresses for optional attendees
attendees_required	string	No	Array of email addresses for required attendees
attendees_resource	string	No	Array of email addresses for resources (meeting rooms, equipment)
body_content	string	No	No description
body_contentType	string	No	No description
end_datetime	string	Yes	No description
end_timezone	string	Yes	No description
hideAttendees	boolean	No	When true, each attendee only sees themselves
importance	string	No	Event importance level
isAllDay	boolean	No	Mark as all-day event
isOnlineMeeting	boolean	No	Create an online meeting (Teams/Skype)
isReminderOn	boolean	No	Enable or disable reminder
location	string	No	No description
locations	string	No	JSON array of location objects with displayName, address, coordinates
onlineMeetingProvider	string	No	Online meeting provider
recurrence_days_of_week	string	No	Days of week for weekly recurrence (comma-separated)
recurrence_end_date	string	No	End date for recurrence (YYYY-MM-DD), required if range_type is endDate
recurrence_interval	integer	No	How often the event recurs (e.g., every 2 weeks = 2)
recurrence_occurrences	integer	No	Number of occurrences, required if range_type is numbered
recurrence_range_type	string	No	How the recurrence ends
recurrence_start_date	string	No	Start date for recurrence (YYYY-MM-DD)
recurrence_type	string	No	Recurrence pattern type
reminderMinutesBeforeStart	integer	No	Minutes before event start to show reminder
sensitivity	string	No	Event sensitivity/privacy level
showAs	string	No	Free/busy status
start_datetime	string	Yes	No description
start_timezone	string	Yes	No description
subject	string	Yes	No description

outlook_delete_calendar_event

Delete a calendar event by ID.

Name	Type	Required	Description
event_id	string	Yes	No description

outlook_get_calendar_event

Retrieve an existing calendar event by ID from the user’s Outlook calendar.

Name	Type	Required	Description
event_id	string	Yes	No description

outlook_list_calendar_events

List calendar events from the user’s Outlook calendar with filtering, sorting, pagination, and field selection.

Name	Type	Required	Description
filter	string	No	OData filter expression to filter events (e.g., startsWith(subject,‘All’))
orderby	string	No	OData orderby expression to sort events (e.g., start/dateTime desc)
select	string	No	Comma-separated list of properties to include in the response
skip	number	No	Number of events to skip for pagination
top	number	No	Maximum number of events to return

outlook_update_calendar_event

Update an existing Outlook calendar event. Only provided fields will be updated. Supports time, attendees, location, reminders, online meetings, recurrence, and event properties.

Name	Type	Required	Description
attendees_optional	string	No	Comma-separated optional attendee emails
attendees_required	string	No	Comma-separated required attendee emails
attendees_resource	string	No	Comma-separated resource emails (meeting rooms, equipment)
body_content	string	No	Event description/body
body_contentType	string	No	Content type of body
categories	string	No	Comma-separated categories
end_datetime	string	No	Event end time in RFC3339 format
end_timezone	string	No	Timezone for end time
event_id	string	Yes	The ID of the calendar event to update
hideAttendees	boolean	No	When true, each attendee only sees themselves
importance	string	No	Event importance level
isAllDay	boolean	No	Mark as all-day event
isOnlineMeeting	boolean	No	Create an online meeting (Teams/Skype)
isReminderOn	boolean	No	Enable or disable reminder
location	string	No	Physical or virtual location
locations	string	No	JSON array of location objects with displayName, address, coordinates
onlineMeetingProvider	string	No	Online meeting provider
recurrence_days_of_week	string	No	Days of week for weekly recurrence (comma-separated)
recurrence_end_date	string	No	End date for recurrence (YYYY-MM-DD)
recurrence_interval	integer	No	How often the event recurs (e.g., every 2 weeks = 2)
recurrence_occurrences	integer	No	Number of occurrences
recurrence_range_type	string	No	How the recurrence ends
recurrence_start_date	string	No	Start date for recurrence (YYYY-MM-DD)
recurrence_type	string	No	Recurrence pattern type
reminderMinutesBeforeStart	integer	No	Minutes before event start to show reminder
sensitivity	string	No	Event sensitivity/privacy level
showAs	string	No	Free/busy status
start_datetime	string	No	Event start time in RFC3339 format
start_timezone	string	No	Timezone for start time
subject	string	No	Event title/summary