Transforming Shared Mailboxes into AI-Powered Service Hubs

Azure Backend Service - REST API

• GET
  /health

  Health check endpoint for uptime monitoring.

• GET
  /api/mailbox/messages

  Fetch messages from the shared mailbox's Inbox.

• GET
  /api/mailbox/messages/poll

  Polling endpoint returning new messages newest-first, backing the connector's NewMessageReceived trigger.

• GET
  /api/mailbox/messages/{id}

  Fetch a single message by id.

• POST
  /api/mailbox/classify

  Classify a message using rule-based (and future AI-powered) classification.

• POST
  /api/mailbox/drafts

  Create a reply draft (reply or reply-all) in the shared mailbox's Drafts folder.

• PATCH
  /api/mailbox/drafts/{id}

  Update an existing draft's subject, body, or recipients.

• POST
  /api/mailbox/messages/send

  Send a new (non-reply) message from the shared mailbox.

• POST
  /api/mailbox/drafts/{id}/send

  Send an existing draft as-is.

• PATCH
  /api/mailbox/messages/{id}/categories

  Set/replace a message's Outlook categories after classification.

• GET
  /api/mailbox/folders

  List mail folders (and subfolders) to resolve destination folder ids.

• POST
  /api/mailbox/messages/{id}/move

  Move a message to a different mail folder (e.g. a department subfolder).

• GET
  /api/mailbox/messages/delta

  Delta query for incremental sync - tracks new, changed, and deleted messages.

• GET
  /api/mailbox/messages/{id}/attachments

  List a message's attachments (metadata only).

• GET
  /api/mailbox/messages/{id}/attachments/{attachmentId}

  Fetch a single attachment, including base64 content bytes.

• GET
  /api/mailbox/messages/{id}/extended-properties

  Read a MAPI extended property (e.g. internal routing metadata) on a message.

• PATCH
  /api/mailbox/messages/{id}/extended-properties

  Write a MAPI extended property on a message.

SharedMailboxConnector - Custom Connector

• Trigger
  NewMessageReceived

  Polling trigger powering Copilot Studio autonomous agents that react to new mail without a conversation.

• Action
  GetMessages

  Retrieve recent messages from the shared mailbox Inbox.

• Action
  GetMessage

  Retrieve a single message by id.

• Action
  ClassifyMessage

  Run rule-based classification and return a target department/confidence.

• Action
  CreateDraft

  Create a reply or reply-all draft for a message.

• Action
  UpdateDraft

  Update a draft's subject, body, or recipients before sending.

• Action
  SendMessage

  Send a brand-new message from the shared mailbox.

• Action
  SendDraftMessage

  Send an existing draft, e.g. after human approval.

• Action
  GetMailFolders

  List top-level or nested mail folders to resolve a destination folder id.

• Action
  UpdateMessageCategories

  Tag a message with Outlook categories after classification.

• Action
  MoveMessage

  Move a message into a department or other mail folder.

• Action
  GetMessagesDelta

  Incremental delta sync of new, changed, and deleted messages.

• Action
  GetAttachments

  List a message's attachment metadata.

• Action
  GetAttachment

  Fetch one attachment's content, including base64 bytes.

• Action
  GetExtendedProperty

  Read a custom MAPI extended property from a message.

• Action
  SetExtendedProperty

  Write a custom MAPI extended property onto a message.

Authentication is delegated Azure AD OAuth2 (accessCode flow) so each allowlisted user signs in with their own Entra ID identity - no app-only credentials are used for connector actions.