MC921752 - Retirement of the SharePoint SendEmail API

Updated June 5, 2025: As a reminder from the post announced on October 31st, 2024, we will be retiring the Utility.SendEmail API on October 31st, 2025. 

In addition, you are now able to identify usage of the API via the Purview audit logs in the admin center

1.  As a tenant admin, navigate to the Microsoft Purview Portal available within the Microsoft 365 Admin Center.
2. Open Audit to search for activities.
3.  Select a date range to run the audit search for (recommend running it for at least 90 days)
4. Put the following text, “SendEmailApiInvoked” into the “Activities – operation names” textbox and click search.
5. The request will be queued, and results will be available once processed.
6. 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:

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
4. Learn about the Microsoft Purview portal | Microsoft Learn