Microsoft Exchange

aid: microsoft-exchange
name: Microsoft Exchange
description: >-
  A comprehensive API collection for Microsoft Exchange Server and Exchange Online, providing programmatic access to
  email, calendars, contacts, and other mailbox resources through Microsoft Graph, EWS, PowerShell, Autodiscover, and
  the Exchange Online Admin API.
type: Index
image: https://learn.microsoft.com/en-us/media/logos/logo-ms-social.png
tags:
  - Calendar
  - Collaboration
  - Contacts
  - Email
  - Enterprise
created: '2024-01-01'
modified: '2026-05-19'
url: https://raw.githubusercontent.com/api-evangelist/microsoft-exchange/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
  - name: Microsoft Graph Mail API
    description: >-
      Access Exchange Online mailboxes through the Microsoft Graph API, providing modern REST endpoints for reading,
      sending, and managing email messages, drafts, attachments, and mail folders.
    image: https://learn.microsoft.com/en-us/media/logos/logo-ms-social.png
    humanURL: https://learn.microsoft.com/en-us/graph/api/resources/mail-api-overview
    baseURL: https://graph.microsoft.com/v1.0
    tags:
      - Email
      - Mail
      - Messaging
      - Microsoft Graph
      - REST
    properties:
      - type: Documentation
        url: https://learn.microsoft.com/en-us/graph/api/resources/mail-api-overview
      - type: OpenAPI
        url: openapi/microsoft-exchange-graph-mail-openapi.yml
      - type: OpenAPI
        url: https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/master/openapi/v1.0/openapi.yaml
      - type: Authentication
        url: https://learn.microsoft.com/en-us/graph/auth/
      - type: GettingStarted
        url: https://developer.microsoft.com/en-us/graph/quick-start
      - type: SDKs
        url: https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
      - type: ChangeLog
        url: https://developer.microsoft.com/en-us/graph/changelog
    contact:
      - FN: Microsoft Support
        email: support@microsoft.com
        url: https://support.microsoft.com
  - name: Microsoft Graph Calendar API
    description: >-
      Manage calendar events, meetings, and scheduling for Exchange Online users. Provides endpoints for creating,
      updating, and deleting events, managing attendees, and handling recurring meetings.
    image: https://learn.microsoft.com/en-us/media/logos/logo-ms-social.png
    humanURL: https://learn.microsoft.com/en-us/graph/api/resources/calendar
    baseURL: https://graph.microsoft.com/v1.0
    tags:
      - Calendar
      - Events
      - Meetings
      - Microsoft Graph
      - Scheduling
    properties:
      - type: Documentation
        url: https://learn.microsoft.com/en-us/graph/api/resources/calendar
      - type: OpenAPI
        url: openapi/microsoft-exchange-graph-calendar-openapi.yml
      - type: OpenAPI
        url: https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/master/openapi/v1.0/openapi.yaml
      - type: Authentication
        url: https://learn.microsoft.com/en-us/graph/auth/
      - type: GettingStarted
        url: https://developer.microsoft.com/en-us/graph/quick-start
      - type: SDKs
        url: https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
      - type: ChangeLog
        url: https://developer.microsoft.com/en-us/graph/changelog
  - name: Microsoft Graph Contacts API
    description: >-
      Manage Outlook personal contacts and contact folders for Exchange Online users. Supports creating, reading,
      updating, and deleting contacts, organizing them into folders, and assigning categories.
    image: https://learn.microsoft.com/en-us/media/logos/logo-ms-social.png
    humanURL: https://learn.microsoft.com/en-us/graph/outlook-contacts-concept-overview
    baseURL: https://graph.microsoft.com/v1.0
    tags:
      - Address Book
      - Contacts
      - Microsoft Graph
      - Outlook
      - People
    properties:
      - type: Documentation
        url: https://learn.microsoft.com/en-us/graph/outlook-contacts-concept-overview
      - type: Reference
        url: https://learn.microsoft.com/en-us/graph/api/resources/contact?view=graph-rest-1.0
      - type: OpenAPI
        url: openapi/microsoft-exchange-graph-contacts-openapi.yml
      - type: OpenAPI
        url: https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/master/openapi/v1.0/openapi.yaml
      - type: Authentication
        url: https://learn.microsoft.com/en-us/graph/auth/
      - type: SDKs
        url: https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
  - name: Microsoft Graph People API
    description: >-
      Retrieve people most relevant to a user based on communication and collaboration patterns, business relationships,
      and contacts. Useful for people-picking scenarios and social intelligence features.
    image: https://learn.microsoft.com/en-us/media/logos/logo-ms-social.png
    humanURL: https://learn.microsoft.com/en-us/graph/people-insights-overview
    baseURL: https://graph.microsoft.com/v1.0
    tags:
      - Collaboration
      - Contacts
      - Microsoft Graph
      - People
      - Social Intelligence
    properties:
      - type: Documentation
        url: https://learn.microsoft.com/en-us/graph/people-insights-overview
      - type: Reference
        url: https://learn.microsoft.com/en-us/graph/api/user-list-people?view=graph-rest-1.0
      - type: OpenAPI
        url: openapi/microsoft-exchange-graph-people-openapi.yml
      - type: OpenAPI
        url: https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/master/openapi/v1.0/openapi.yaml
      - type: Authentication
        url: https://learn.microsoft.com/en-us/graph/auth/
      - type: SDKs
        url: https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
  - name: Exchange Web Services (EWS)
    description: >-
      Legacy SOAP-based API for Exchange Server providing comprehensive access to mailbox data and operations. Planned
      for deprecation in Exchange Online in October 2026, with Microsoft Graph recommended for new development.
    image: https://learn.microsoft.com/en-us/media/logos/logo-ms-social.png
    humanURL: >-
      https://learn.microsoft.com/en-us/exchange/client-developer/exchange-web-services/explore-the-ews-managed-api-ews-and-web-services-in-exchange
    baseURL: https://outlook.office365.com/EWS/Exchange.asmx
    tags:
      - Exchange Server
      - Legacy
      - Mailbox
      - SOAP
      - Web Services
    properties:
      - type: Documentation
        url: >-
          https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/web-services-reference-for-exchange
      - type: WSDL
        url: https://outlook.office365.com/EWS/Exchange.asmx?wsdl
      - type: SDK
        url: https://github.com/officedev/ews-managed-api
      - type: Reference
        url: >-
          https://learn.microsoft.com/en-us/exchange/client-developer/exchange-web-services/explore-the-ews-managed-api-ews-and-web-services-in-exchange
      - type: GettingStarted
        url: https://learn.microsoft.com/en-us/exchange/client-developer/exchange-server-development
  - name: Exchange Online PowerShell API
    description: >-
      PowerShell module for managing Exchange Online through REST-based cmdlets. Provides the complete Exchange
      management surface for administrative tasks including mailbox management, mail flow rules, and organization
      configuration.
    image: https://learn.microsoft.com/en-us/media/logos/logo-ms-social.png
    humanURL: https://learn.microsoft.com/en-us/powershell/exchange/exchange-online-powershell
    baseURL: https://outlook.office365.com/powershell-liveid/
    tags:
      - Administration
      - Automation
      - Exchange Online
      - Management
      - PowerShell
    properties:
      - type: Documentation
        url: https://learn.microsoft.com/en-us/powershell/exchange/exchange-online-powershell-v2
      - type: Installation Guide
        url: >-
          https://learn.microsoft.com/en-us/powershell/exchange/exchange-online-powershell-v2#install-and-maintain-the-exchange-online-powershell-module
      - type: Authentication
        url: https://learn.microsoft.com/en-us/powershell/exchange/connect-to-exchange-online-powershell
      - type: Reference
        url: https://learn.microsoft.com/en-us/powershell/exchange/exchange-online-powershell
  - name: Exchange Autodiscover API
    description: >-
      Service that enables client applications to automatically configure themselves for Exchange connectivity using
      minimal user input. Supports SOAP and POX protocols for discovering EWS endpoint URLs and other Exchange service
      settings.
    image: https://learn.microsoft.com/en-us/media/logos/logo-ms-social.png
    humanURL: https://learn.microsoft.com/en-us/exchange/client-developer/exchange-web-services/autodiscover-for-exchange
    baseURL: https://outlook.office365.com/autodiscover/autodiscover.svc
    tags:
      - Autodiscover
      - Configuration
      - Exchange Server
      - Service Discovery
      - SOAP
    properties:
      - type: Documentation
        url: https://learn.microsoft.com/en-us/exchange/client-developer/exchange-web-services/autodiscover-for-exchange
      - type: Reference
        url: >-
          https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/soap-autodiscover-web-service-reference-for-exchange
      - type: SDK
        url: https://github.com/officedev/ews-managed-api
  - name: Exchange Online Admin API
    description: >-
      REST-based administrative API that provides cmdlet-style endpoints for Exchange Online management tasks previously
      available through EWS. Supports organization configuration, mailbox folder permissions, distribution group
      membership, and delegation management.
    image: https://learn.microsoft.com/en-us/media/logos/logo-ms-social.png
    humanURL: https://learn.microsoft.com/en-us/exchange/reference/admin-api-overview
    baseURL: https://outlook.office365.com/adminapi/v2.0
    tags:
      - Administration
      - Exchange Online
      - Management
      - Permissions
      - REST
    properties:
      - type: Documentation
        url: https://learn.microsoft.com/en-us/exchange/reference/admin-api-overview
      - type: OpenAPI
        url: openapi/microsoft-exchange-admin-api-openapi.yml
      - type: GettingStarted
        url: https://learn.microsoft.com/en-us/exchange/reference/admin-api-get-started
      - type: Authentication
        url: https://learn.microsoft.com/en-us/exchange/reference/admin-api-authentication
  - name: Microsoft Graph Mailbox Import Export API
    description: >-
      APIs for discovering, importing, and exporting content from Exchange Online mailboxes in full fidelity. Enables
      mailbox migration scenarios and content copying as a replacement for EWS-based approaches.
    image: https://learn.microsoft.com/en-us/media/logos/logo-ms-social.png
    humanURL: https://learn.microsoft.com/en-us/graph/mailbox-import-export-concept-overview
    baseURL: https://graph.microsoft.com/beta
    tags:
      - Export
      - Import
      - Mailbox
      - Microsoft Graph
      - Migration
    properties:
      - type: Documentation
        url: https://learn.microsoft.com/en-us/graph/mailbox-import-export-concept-overview
      - type: OpenAPI
        url: openapi/microsoft-exchange-graph-import-export-openapi.yml
      - type: Reference
        url: https://learn.microsoft.com/en-us/graph/api/resources/mailbox-import-export-api-overview?view=graph-rest-beta
      - type: Authentication
        url: https://learn.microsoft.com/en-us/graph/auth/
      - type: SDKs
        url: https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
common:
  - type: PostmanWorkspace
    url: https://www.postman.com/kinlaneapi/microsoft-exchange/overview
  - type: ArazzoWorkflows
    url: arazzo/
    workflows:
      - url: arazzo/microsoft-exchange-audit-message-attachments-workflow.yml
        name: Microsoft Exchange Audit Message Attachments
        summary: Find a message that has attachments, read it, and list its attachments.
      - url: arazzo/microsoft-exchange-audit-org-and-domains-workflow.yml
        name: Microsoft Exchange Audit Organization and Domains
        summary: Read Exchange organization configuration, then list accepted domains.
      - url: arazzo/microsoft-exchange-compose-attach-send-mail-workflow.yml
        name: Microsoft Exchange Compose, Attach, and Send Mail
        summary: Create a draft message, add a file attachment to it, then send the draft.
      - url: arazzo/microsoft-exchange-discover-mailbox-content-workflow.yml
        name: Microsoft Exchange Discover Mailbox Content
        summary: Discover a user's mailbox, drill into its folders, and list folder items.
      - url: arazzo/microsoft-exchange-find-times-and-book-meeting-workflow.yml
        name: Microsoft Exchange Find Times and Book a Meeting
        summary: Suggest meeting times for attendees, then book the top suggestion.
      - url: arazzo/microsoft-exchange-grant-folder-permission-workflow.yml
        name: Microsoft Exchange Grant a Mailbox Folder Permission
        summary: Read current folder permissions, then add a permission for a user.
      - url: arazzo/microsoft-exchange-inspect-and-delegate-mailbox-workflow.yml
        name: Microsoft Exchange Inspect and Delegate a Mailbox
        summary: Read a mailbox's properties, then grant Send on Behalf delegation.
      - url: arazzo/microsoft-exchange-migrate-mailbox-item-workflow.yml
        name: Microsoft Exchange Migrate a Mailbox Item
        summary: Pick a source item, export its full MIME content, and import it elsewhere.
      - url: arazzo/microsoft-exchange-organize-contacts-folder-workflow.yml
        name: Microsoft Exchange Organize a Contacts Folder
        summary: Create a contact folder, add a contact to it, and read the contact back.
      - url: arazzo/microsoft-exchange-organize-folder-and-file-message-workflow.yml
        name: Microsoft Exchange Organize a Folder and File a Message
        summary: Create a mail folder, confirm it, and create a message inside it.
      - url: arazzo/microsoft-exchange-prepare-and-send-forward-workflow.yml
        name: Microsoft Exchange Prepare and Send a Forward
        summary: Create a forward draft, edit its body, and send it to new recipients.
      - url: arazzo/microsoft-exchange-provision-calendar-and-add-event-workflow.yml
        name: Microsoft Exchange Provision a Calendar and Add an Event
        summary: Create a new calendar, add an event to it, and read the event back.
      - url: arazzo/microsoft-exchange-reply-to-latest-from-sender-workflow.yml
        name: Microsoft Exchange Reply to Latest Message from a Sender
        summary: Find the newest message from a given sender, read it, and send a reply.
      - url: arazzo/microsoft-exchange-review-and-respond-to-invite-workflow.yml
        name: Microsoft Exchange Review and Respond to an Invite
        summary: List upcoming events, read the next one, and accept the invitation.
      - url: arazzo/microsoft-exchange-schedule-event-with-attachment-workflow.yml
        name: Microsoft Exchange Schedule an Event with an Attachment
        summary: Create a calendar event, confirm it, then attach a file to it.
      - url: arazzo/microsoft-exchange-triage-and-move-message-workflow.yml
        name: Microsoft Exchange Triage and Move a Message
        summary: Find the newest unread inbox message, read it, mark it read, and file it.
      - url: arazzo/microsoft-exchange-upsert-contact-workflow.yml
        name: Microsoft Exchange Upsert a Contact
        summary: Find a contact by email and update it if it exists, otherwise create it.
  - type: Portal
    url: https://developer.microsoft.com/en-us/graph
  - type: Documentation
    url: https://learn.microsoft.com/en-us/exchange/client-developer/exchange-server-development
  - type: GettingStarted
    url: https://developer.microsoft.com/en-us/graph/quick-start
  - type: Authentication
    url: https://learn.microsoft.com/en-us/graph/auth/
  - type: Blog
    url: https://devblogs.microsoft.com/microsoft365dev/tag/exchange/
  - type: StatusPage
    url: https://status.office365.com/
  - type: Support
    url: https://support.microsoft.com/en-us/office
  - type: TermsOfService
    url: https://www.microsoft.com/en-us/legal/terms-of-use
  - type: PrivacyPolicy
    url: https://privacy.microsoft.com/en-us/privacystatement
  - type: GitHubOrganization
    url: https://github.com/OfficeDev
  - type: Community
    url: https://techcommunity.microsoft.com/category/exchange
  - type: Website
    url: https://www.microsoft.com/en-us/microsoft-365/exchange/email
  - type: Login
    url: https://admin.exchange.microsoft.com
  - type: SignUp
    url: https://signup.azure.com/
  - type: ChangeLog
    url: https://developer.microsoft.com/en-us/graph/changelog
  - type: SDKs
    url: https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
  - type: Pricing
    url: https://www.microsoft.com/en-us/microsoft-365/exchange/compare-microsoft-exchange-online-plans
  - type: Graph Explorer
    url: https://developer.microsoft.com/en-us/graph/graph-explorer
  - type: JSON-LD Context
    url: json-ld/microsoft-exchange-context.jsonld
  - type: JSON Schema
    url: json-schema/microsoft-exchange-message-schema.json
  - type: JSON Schema
    url: json-schema/microsoft-exchange-event-schema.json
  - type: JSON Schema
    url: json-schema/microsoft-exchange-contact-schema.json
  - type: JSON Schema
    url: json-schema/microsoft-exchange-calendar-schema.json
  - type: JSON Schema
    url: json-schema/microsoft-exchange-mail-folder-schema.json
  - type: JSON Schema
    url: json-schema/microsoft-exchange-person-schema.json
  - type: Integrations
    url: https://www.microsoft.com/en-us/marketplace
integrations:
  - name: Microsoft
  - name: Two people looking at a computer.
  - name: This is placeholder text for
  - name: IDC
  - name: Nationwide
  - name: RSA company
  - name: Teleperformance
  - name: A woman smiling at a laptop
  - name: A man holding a laptop.
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com
    url: https://apievangelist.com