MC921752 – M365 Change Digest

One-line summary

The Utility.SendEmail API in SharePoint Online will be retired on October 31, 2025; update custom code and workflows to use Microsoft Graph or Outlook connectors before then.

Similar updates

Details

Summary

The SharePoint Utility.SendEmail API will retire on October 31, 2025. Tenants should identify usage via Purview audit logs and update any custom code or Power Automate flows using this API. Alternatives include Microsoft Graph SendMail API and Outlook connector in Power Automate.

Body (from Message Center)

Updated October 1, 2025: As previously announced in the October 31st, 2024, post, we will be retiring the Utility.SendEmail API on October 31st, 2025.

As a reminder, you are able to identify usage of the API via the Purview audit logs in the admin center

As a tenant admin, navigate to the Microsoft Purview Portal available within the Microsoft 365 Admin Center.
Open Audit to search for activities.
Select a date range to run the audit search for (recommend running it for at least 90 days)
Put the following text, “SendEmailApiInvoked” into the “Activities – operation names” textbox and click search.
The request will be queued, and results will be available once processed.
Click on the results and review each of the items.

Use the UserAgent and ApplicationDisplayName to help identify the caller.

[NOTE:] If the ApplicationDisplayName = “Workflow” then the items will be unaffected by this API retirement but will follow the SharePoint 2013 Workflow retirement. We will be retiring the Utility.SendEmail API from SharePoint. The SP.Utilities.Utility.SendEmail could be used to send emails from custom applications or processes within SharePoint Online, including Power Automate, and custom workflows.

From custom code the API can be referenced via REST as (“/_api/SP.Utilities.Utility.SendEmail”) while for CSOM, it would be “Utility.SendEmail” with more information on the original implementation at Utility.SendEmail method for CSOM.

[When this will happen:]

October 31, 2025

[How this will affect your organization:]

Any components, custom code, or Power Automate connections that utilize the SP.Utilities.Utility.SendEmail API, should be updated before the end of life date. The API will stop providing services on the retirement date and will no longer send any email requests from that date.

[What you need to do to prepare:]

Migrate any custom code, power automate, processes or policies running within SharePoint Online that have been configured to send email using the SP.Utilities.Utility.SendEmail API.

The following are recommended or alternative approaches:

Use Microsoft Graph to send email using the user: SendMail API (Part of the Outlook mail workload) Automate creating, sending, and processing messages
Customizations through Power Automate may also utilize the Outlook connector and utilize “Send an email” within the Actions. Overview of using Outlook and Power Automate

Learn more:

Raw JSON (for debugging)

Expand/collapse the full payload below.

Show/hide raw

{
  "snapshot_item": {
    "action_required_by": null,
    "ai_action_required_by": null,
    "ai_actions": [
      "Audit current API usage via Purview logs",
      "Migrate custom code and workflows to Microsoft Graph or Outlook connectors",
      "Update Power Automate flows using the retiring API"
    ],
    "ai_master_tags": [],
    "ai_model": "gpt-4.1",
    "ai_summary": "The Utility.SendEmail API in SharePoint Online will be retired on October 31, 2025; update custom code and workflows to use Microsoft Graph or Outlook connectors before then.",
    "ai_topics": [
      "SharePoint",
      "Power Apps",
      "Power Automate",
      "Power Platform",
      "Outlook"
    ],
    "category": "planForChange",
    "details_map": {
      "Summary": "The SharePoint Utility.SendEmail API will retire on October 31, 2025. Tenants should identify usage via Purview audit logs and update any custom code or Power Automate flows using this API. Alternatives include Microsoft Graph SendMail API and Outlook connector in Power Automate."
    },
    "id": "MC921752",
    "importance": 5,
    "is_major_change": true,
    "last_modified": "2025-11-03T21:49:48Z",
    "ms_products": [
      "SharePoint",
      "Power Apps",
      "Power Automate"
    ],
    "platforms": null,
    "roadmap_ids": [],
    "services": [
      "SharePoint Online",
      "Power Apps in Microsoft 365",
      "Microsoft Power Automate in Microsoft 365"
    ],
    "severity": "normal",
    "tags": [
      "Updated message",
      "User impact",
      "Admin impact",
      "Retirement"
    ],
    "title": "(Updated) Retirement of the SharePoint SendEmail API"
  }
}