Microsoft Outlook Integration

Overview

Add Microsoft Outlook to any ModuleX agent or workflow. Send, draft, search, and organize email; manage contacts, folders, and categories in Microsoft Outlook via Microsoft Graph (graph.microsoft.com/v1.0). Uses delegated permissions on behalf of an authenticated Microsoft 365 user.

Categories: Communication · Email · Productivity · Communication · Microsoft · Auth: OAuth2 · Actions: 20

Authentication

OAuth2 Authentication

Connect with your Microsoft account using OAuth 2.0 against the Microsoft identity platform.

Step 1

Step 2

Under ‘Authentication’, add the redirect URI: https://api.modulex.dev/credentials/oauth2/callback

Step 3

Under ‘API permissions’, add Microsoft Graph delegated permissions: Mail.ReadWrite, Mail.Send, MailboxSettings.Read, Contacts.ReadWrite, User.Read, User.ReadBasic.All, offline_access

Step 4

Under ‘Certificates & secrets’, create a new client secret

Step 5

Copy the Application (client) ID and the client secret into ModuleX

Required Credentials

Field	Description	Required	Format
Client ID	Microsoft Entra Application (client) ID for the Microsoft Graph app.	Yes	`00000000-0000-0000-0000-000000000000`
Client Secret	Microsoft Entra client secret for the Microsoft Graph app.	Yes	`-`

OAuth Configuration

Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token
Scopes: offline_access, User.Read, User.ReadBasic.All, Mail.ReadWrite, Mail.Send, MailboxSettings.Read, Contacts.ReadWrite

Available Actions

add_label_to_email — Adds a label/category to an email in Microsoft Outlook.

Parameters

string

required

The identifier of the message to update.

string

required

The name of the label/category to add.

string

The User ID of a shared mailbox. If not provided, defaults to the authenticated user’s mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "subject": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Subject"
    },
    "categories": {
      "items": {
        "type": "string"
      },
      "title": "Categories",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "AddLabelToEmailOutput",
  "type": "object"
}

approve_workflow — Send an email containing approve/cancel URLs to a recipient so they can resume or cancel a workflow externally. The caller (workflow engine) is responsible for generating the resume/cancel URLs and passing them in.

Parameters

array

required

Array of recipient email addresses.

string

required

Subject of the approval email.

string

required

URL the recipient clicks to approve / resume the workflow.

string

required

URL the recipient clicks to cancel the workflow.

string

The User ID of a shared mailbox. If not provided, defaults to the authenticated user’s mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "sent": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Sent"
    }
  },
  "required": [
    "success"
  ],
  "title": "ApproveWorkflowOutput",
  "type": "object"
}

create_contact — Add a contact to the root Contacts folder.

Parameters

string

Given name of the contact.

string

Surname of the contact.

array

Email addresses for the contact (list of strings).

array

Array of phone numbers (list of strings).

object

Additional contact details to merge into the request body. See https://docs.microsoft.com/en-us/graph/api/resources/contact

Response

{
  "$defs": {
    "ContactSummary": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "displayName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Displayname"
        },
        "givenName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Givenname"
        },
        "surname": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Surname"
        },
        "emailAddresses": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Emailaddresses",
          "type": "array"
        },
        "businessPhones": {
          "items": {
            "type": "string"
          },
          "title": "Businessphones",
          "type": "array"
        }
      },
      "title": "ContactSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "contact": {
      "anyOf": [
        {
          "$ref": "#/$defs/ContactSummary"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateContactOutput",
  "type": "object"
}

create_draft_email — Create a draft email.

Parameters

array

Array of TO recipient email addresses (list of strings).

array

Array of CC recipient email addresses (list of strings).

array

Array of BCC recipient email addresses (list of strings).

string

Subject of the email.

string

Content type of the body. Valid values: text, html. (Default: text)

string

Body content of the email in text or HTML.

array

Array of file URLs to fetch and attach to the message (list of strings).

object

Additional Message resource fields merged into the request. See https://docs.microsoft.com/en-us/graph/api/resources/message

string

The User ID of a shared mailbox. If not provided, defaults to the authenticated user’s mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "subject": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Subject"
    },
    "isDraft": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Isdraft"
    },
    "webLink": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Weblink"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateDraftEmailOutput",
  "type": "object"
}

create_draft_reply — Create a draft reply to an email.

Parameters

string

required

The identifier of the message to reply to.

string

Content of the reply in text format.

array

Array of TO recipient email addresses to override on the draft (list of strings).

array

Array of CC recipient email addresses (list of strings).

array

Array of BCC recipient email addresses (list of strings).

string

Subject override for the reply.

array

Array of file URLs to attach to the reply (list of strings).

object

Additional Message resource fields merged into the message body.

string

The User ID of a shared mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "subject": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Subject"
    },
    "isDraft": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Isdraft"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateDraftReplyOutput",
  "type": "object"
}

download_attachment — Downloads an attachment from a message and returns it as base64-encoded content with metadata.

Parameters

string

required

The identifier of the message containing the attachment.

string

required

The identifier of the attachment to download.

string

The User ID of a shared mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "content_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Content Type"
    },
    "size": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Size"
    },
    "content_bytes_base64": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Content Bytes Base64"
    }
  },
  "required": [
    "success"
  ],
  "title": "DownloadAttachmentOutput",
  "type": "object"
}

find_contacts — Finds contacts with the given search string.

Parameters

string

required

Provide email address, given name, surname, or display name (case sensitive).

integer

The maximum number of results to return. (Default: 100)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "contacts": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Contacts",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "FindContactsOutput",
  "type": "object"
}

find_email — Search for an email in Microsoft Outlook. $search cannot be combined with $filter or $orderby.

Parameters

string

Search query. Can use property syntax like “to:example@example.com” or “subject:example”. Not for use with filter or order_by.

string

OData $filter expression, e.g. contains(subject, ‘meet for lunch?’). Not for use with search.

string

OData $orderby expression, e.g. receivedDateTime desc. Not for use with search.

integer

Maximum number of messages to return. (Default: 100)

boolean

If true, expands attachments on each returned message. (Default: false)

string

Comma-separated message property names to return (e.g. id,subject,from,receivedDateTime). Shrinks payload size.

string

The User ID of a shared mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "messages": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Messages",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "FindEmailOutput",
  "type": "object"
}

find_shared_folder_email — Search for an email in a shared folder.

Parameters

string

required

The user ID owning the shared folder.

string

required

The ID of the shared folder to search.

string

Search query. Not for use with filter or order_by.

string

OData $filter expression.

string

OData $orderby expression.

integer

Maximum number of messages to return. (Default: 100)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "messages": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Messages",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "FindSharedFolderEmailOutput",
  "type": "object"
}

get_current_user — Returns the authenticated Microsoft user's ID, display name, email, and principal name via Microsoft Graph. Call this first when the user says 'my emails', 'my inbox', or needs identity context.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "displayName": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Displayname"
    },
    "mail": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Mail"
    },
    "userPrincipalName": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Userprincipalname"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetCurrentUserOutput",
  "type": "object"
}

get_message — Retrieve a single email message by its Microsoft Graph message ID.

Parameters

string

required

The Microsoft Graph message ID.

boolean

If true, expands attachments on the returned message. (Default: false)

string

The User ID of a shared mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "message": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Message"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetMessageOutput",
  "type": "object"
}

list_contacts — Get a contact collection from the default contacts folder.

Parameters

string

If provided, only contacts with the given email address will be retrieved.

integer

Maximum number of contacts to return. (Default: 100)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "contacts": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Contacts",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListContactsOutput",
  "type": "object"
}

list_folders — Retrieves a list of mail folders in Microsoft Outlook.

Parameters

integer

Maximum number of folders to return. (Default: 100)

boolean

If true, recursively include subfolders. (Default: false)

boolean

If true, include hidden folders. (Default: false)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "folders": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Folders",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListFoldersOutput",
  "type": "object"
}

list_important_mail — Get the most important mail from the user's Inbox (filters by high importance or flagged status).

Parameters

integer

Maximum number of messages to return. (Default: 100)

string

The User ID of a shared mailbox.

Response

{
  "$defs": {
    "ImportantMailItem": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "subject": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Subject"
        },
        "sender": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Sender"
        },
        "receivedDateTime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Receiveddatetime"
        }
      },
      "title": "ImportantMailItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "data": {
      "items": {
        "$ref": "#/$defs/ImportantMailItem"
      },
      "title": "Data",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListImportantMailOutput",
  "type": "object"
}

list_labels — Get all the labels/categories that have been defined for a user.

Parameters

string

The User ID of a shared mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "labels": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Labels",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListLabelsOutput",
  "type": "object"
}

move_email_to_folder — Moves an email to the specified folder.

Parameters

string

required

The identifier of the message to move.

string

required

The identifier of the destination folder.

string

The User ID of a shared mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "parentFolderId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Parentfolderid"
    }
  },
  "required": [
    "success"
  ],
  "title": "MoveEmailToFolderOutput",
  "type": "object"
}

remove_label_from_email — Removes a label/category from an email.

Parameters

string

required

The identifier of the message to update.

string

required

The name of the label/category to remove.

string

The User ID of a shared mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "categories": {
      "items": {
        "type": "string"
      },
      "title": "Categories",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "RemoveLabelFromEmailOutput",
  "type": "object"
}

reply_to_email — Reply to an email.

Parameters

string

required

The identifier of the message to reply to.

string

Content of the reply in text format.

array

Optional override for TO recipients (list of strings).

array

CC recipient email addresses (list of strings).

array

BCC recipient email addresses (list of strings).

string

Optional subject override.

array

Array of file URLs to attach (list of strings).

object

Additional Message resource fields merged into the reply body.

string

The User ID of a shared mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "sent": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Sent"
    }
  },
  "required": [
    "success"
  ],
  "title": "ReplyToEmailOutput",
  "type": "object"
}

send_email — Send an email to one or multiple recipients.

Parameters

array

TO recipient email addresses (list of strings).

array

CC recipient email addresses (list of strings).

array

BCC recipient email addresses (list of strings).

string

Subject of the email.

string

Content type of the body. Valid values: text, html. (Default: text)

string

Body content of the email.

array

Array of file URLs to fetch and attach (list of strings).

object

Additional Message resource fields merged into the request.

string

The User ID of a shared mailbox.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "sent": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Sent"
    }
  },
  "required": [
    "success"
  ],
  "title": "SendEmailOutput",
  "type": "object"
}

update_contact — Update an existing contact.

Parameters

string

required

The ID of the contact to update.

string

Given name of the contact.

string

Surname of the contact.

array

Replacement email addresses for the contact (list of strings).

array

Replacement phone numbers (list of strings).

object

Additional contact fields merged into the request body.

Response

{
  "$defs": {
    "ContactSummary": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "displayName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Displayname"
        },
        "givenName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Givenname"
        },
        "surname": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Surname"
        },
        "emailAddresses": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Emailaddresses",
          "type": "array"
        },
        "businessPhones": {
          "items": {
            "type": "string"
          },
          "title": "Businessphones",
          "type": "array"
        }
      },
      "title": "ContactSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "contact": {
      "anyOf": [
        {
          "$ref": "#/$defs/ContactSummary"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateContactOutput",
  "type": "object"
}

Limits & Quotas

Microsoft Graph throttles per-app and per-mailbox. Mail endpoints allow approximately 10,000 requests per 10 minutes per app per mailbox; consult Microsoft’s throttling guidance for exact tiers.
Search uses Microsoft Graph KQL semantics; combining search with filter or order_by is rejected by Microsoft Graph and short-circuited locally with a success=False error.
Attachments are accepted as URLs only; the integration fetches each URL and base64-encodes the bytes for Microsoft Graph’s fileAttachment payload. download_attachment returns base64-encoded bytes rather than writing files to disk.
The approve_workflow action does not internally suspend a workflow; the caller must supply both resume_url and cancel_url. The action only sends the approval email.
Error model: non-2xx responses are caught and returned as success=False + error; the calling agent can retry or surface the error.

​Overview

​Authentication

​OAuth2 Authentication

​Required Credentials

​OAuth Configuration

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Gmail

AgentMail

Mailgun

​Links

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links