Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
What can you do with it?

Microsoft Outlook allows you to manage your email, calendar, and tasks programmatically through the Microsoft Graph API. You can send and receive emails, create and manage calendar events, work with todo lists and tasks, handle email attachments, organize messages in folders, and search through your communications. This integration is perfect for email automation, calendar scheduling, task management, and unified communication workflows.

​
How to use it?

​
Basic Command Structure

/your-Microsoft-Outlook-connection [action] [required-parameters] [optional-parameters]

​
Parameters

Required:
  • action - The operation to perform with Outlook

​
Tools

​
Send Email

Send an email message Parameters:
  • to (required) - Recipient email address
  • subject (required) - Email subject
  • body (required) - Email content
  • cc (optional) - CC recipients
  • importance (optional) - Email importance level
Example: 
/your-Microsoft-Outlook-connection
action: send-email
to: john@company.com
subject: Project Update
body: Here's the latest status on our project...
importance: high
Response: 
{
  "id": "AAMkAGI2...",
  "subject": "Project Update",
  "bodyPreview": "Here's the latest status...",
  "sentDateTime": "2024-03-15T10:30:00Z"
}

​
List Emails

Get a list of emails from your inbox Parameters:
  • folder (optional) - Mail folder to list from
  • limit (optional) - Number of emails to retrieve
  • unread-only (optional) - Show only unread messages
Example: 
/your-Microsoft-Outlook-connection
action: list-emails
folder: inbox
limit: 10
unread-only: true
Response: 
{
  "value": [
    {
      "id": "AAMkAGI2...",
      "subject": "Meeting Tomorrow",
      "from": {
        "emailAddress": {
          "address": "sender@example.com"
        }
      },
      "isRead": false,
      "receivedDateTime": "2024-03-15T09:00:00Z"
    }
  ]
}

​
Search Emails

Search for emails by query Parameters:
  • query (required) - Search query text
  • folder (optional) - Folder to search in
Example: 
/your-Microsoft-Outlook-connection
action: search-emails
query: project proposal
Response: 
{
  "value": [
    {
      "id": "AAMkAGI2...",
      "subject": "Re: Project Proposal",
      "bodyPreview": "I've reviewed the project proposal...",
      "from": {
        "emailAddress": {
          "address": "manager@company.com"
        }
      }
    }
  ]
}

​
Create Calendar Event

Create a new calendar event Parameters:
  • subject (required) - Event title
  • start (required) - Start date/time (ISO format)
  • end (required) - End date/time (ISO format)
  • location (optional) - Event location
  • attendees (optional) - Comma-separated email addresses
  • body (optional) - Event description
Example: 
/your-Microsoft-Outlook-connection
action: create-event
subject: Team Meeting
start: 2024-03-20T14:00:00
end: 2024-03-20T15:00:00
location: Conference Room A
attendees: team@company.com
Response: 
{
  "id": "AAMkAGI2...",
  "subject": "Team Meeting",
  "start": {
    "dateTime": "2024-03-20T14:00:00",
    "timeZone": "UTC"
  },
  "end": {
    "dateTime": "2024-03-20T15:00:00",
    "timeZone": "UTC"
  },
  "location": {
    "displayName": "Conference Room A"
  }
}

​
List Calendar Events

Get calendar events within a date range Parameters:
  • start-date (optional) - Start date for event listing
  • end-date (optional) - End date for event listing
  • limit (optional) - Maximum number of events
Example: 
/your-Microsoft-Outlook-connection
action: list-events
start-date: 2024-03-15
end-date: 2024-03-22
Response: 
{
  "value": [
    {
      "id": "AAMkAGI2...",
      "subject": "Weekly Standup",
      "start": {
        "dateTime": "2024-03-18T09:00:00"
      },
      "end": {
        "dateTime": "2024-03-18T09:30:00"
      },
      "isAllDay": false
    }
  ]
}

​
List Todo Lists

Get all todo lists Parameters:
  • None required
Example: 
/your-Microsoft-Outlook-connection
action: list-todo-lists
Response: 
{
  "value": [
    {
      "id": "AAMkAGI2...",
      "displayName": "Work Tasks",
      "isOwner": true
    },
    {
      "id": "BBMkAGI3...",
      "displayName": "Personal",
      "isOwner": true
    }
  ]
}

​
Create Task

Create a new task in a todo list Parameters:
  • list-id (required) - ID of the todo list
  • title (required) - Task title
  • due-date (optional) - Due date for the task
  • importance (optional) - Task importance (low, normal, high)
  • body (optional) - Task description
Example: 
/your-Microsoft-Outlook-connection
action: create-task
list-id: AAMkAGI2...
title: Complete quarterly report
due-date: 2024-03-25
importance: high
Response: 
{
  "id": "CCMkAGI4...",
  "title": "Complete quarterly report",
  "importance": "high",
  "status": "notStarted",
  "dueDateTime": {
    "dateTime": "2024-03-25T00:00:00",
    "timeZone": "UTC"
  }
}

​
Download Attachments

Download attachments from an email Parameters:
  • email-id (required) - ID of the email with attachments
Example: 
/your-Microsoft-Outlook-connection
action: download-attachments
email-id: AAMkAGI2...
Response: 
{
  "attachments": [
    {
      "name": "report.pdf",
      "contentType": "application/pdf",
      "size": 102400,
      "saved": true
    }
  ]
}

​
Notes

The integration uses Microsoft Graph API through the PinkConnect proxy. Email attachments are accessed through the contentBytes field in attachment metadata. Calendar events use ISO 8601 date/time format. Search queries cannot be combined with ordering operations. Todo lists must be retrieved first to get list IDs for task operations. The connection ID is required for all operations.