MC921752 - Retirement of the SharePoint SendEmail API

Service

SharePoint Online
Power Apps in Microsoft 365
Microsoft Power Automate in Microsoft 365

Published

Oct 30, 2024

Tag

Major change
User impact
Admin impact
Retirement

Summary

The SharePoint SendEmail API will be retired on October 31, 2025. Organizations should update any components using this API and consider alternatives like Microsoft Graph or Power Automate's Outlook connector for email functionalities.

More information

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:

  1. Use Microsoft Graph to send email using the user: SendMail API (Part of the Outlook mail workload) Automate creating, sending, and processing messages
  2. 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:

  1. Retirement of the SharePoint SendEmail API
  2. Automate creating, sending, and processing messages
  3. Overview of using Outlook and Power Automate