{"id":23308,"date":"2024-10-30T05:41:20","date_gmt":"2024-10-30T12:41:20","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=23308"},"modified":"2024-11-07T22:49:05","modified_gmt":"2024-11-08T06:49:05","slug":"retirement-of-the-sharepoint-sendemail-api","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/retirement-of-the-sharepoint-sendemail-api\/","title":{"rendered":"Retirement of the SharePoint SendEmail API"},"content":{"rendered":"<p>The SharePoint SendEmail API, known as\u00a0<span style=\"font-family: 'courier new', courier, monospace;\"><em><span class=\"ocpCodeInline\">SP.Utilities.Utility.SendEmail<\/span><\/em><\/span>,\u00a0is an API utilized to send email from within the context of SharePoint. This may include usage within Power Automate, custom code, custom workflows, and web parts within SharePoint.<\/p>\n<p>The SendEmail API is referenced via REST in the following way (\u201c<span class=\"ocpCodeInline\" style=\"font-family: 'courier new', courier, monospace;\">\/_api\/SP.Utilities.Utility.SendEmail<\/span>\u201d) while for\u00a0CSOM, it would be \u201c<span class=\"ocpCodeInline\" style=\"font-family: 'courier new', courier, monospace;\">Utility.SendEmail<\/span>\u201d.<\/p>\n<h3>Important<\/h3>\n<ul>\n<li>Please ensure that you follow the guidance and identify and update any use of the API prior to the end-of-life date of October 31st, 2025. No further emails will be sent after this date.<\/li>\n<li>Please review the updates that are sent to the Microsoft 365 message center related to the retirement of this API.<\/li>\n<li>SharePoint workflows will not be affected by this change. Please refer to <a href=\"https:\/\/support.microsoft.com\/office\/sharepoint-2013-workflow-retirement-4613d9cf-69aa-40f7-b6bf-6e7831c9691e\">SharePoint 2013 Workflow retirement<\/a>.<\/li>\n<li>Any out-of-the-box feature in SharePoint, which is sending emails, is not affected by this change.<\/li>\n<li>This change is only impacting SharePoint Online and has not impact on SharePoint on-premises deployments<\/li>\n<\/ul>\n<h2>Steps to follow<\/h2>\n<ol type=\"1\">\n<li>Identify usage of the\u00a0<span class=\"ocpCodeInline\">Utility.SendEmail<\/span>\u00a0API within <strong>custom code<\/strong>, <strong>custom workflows<\/strong>, or through <strong>Power Automate<\/strong> including &#8220;<a class=\"ocpExternalLink\" href=\"https:\/\/learn.microsoft.com\/sharepoint\/dev\/business-apps\/power-automate\/guidance\/working-with-send-sp-http-request\" target=\"_blank\" rel=\"noopener\" data-bi-type=\"anchor\">SharePoint Send HTTP Request flow action in Power Automate<\/a>&#8220;.<\/li>\n<li>For Power Automate, update the API to utilize the\u00a0Outlook connector (\u201cSend an email\u201d) within the Actions. (More information is available at\u00a0<a class=\"ocpExternalLink\" href=\"https:\/\/learn.microsoft.com\/power-automate\/email-overview\" target=\"_blank\" rel=\"noopener\" data-bi-type=\"anchor\">Overview of using Outlook and Power Automate &#8211; Power Automate | Microsoft Learn<\/a>)<\/li>\n<li>For custom code, or custom workflows, utilize Microsoft Graph\u00a0<span class=\"ocpCodeInline\">user:SendMail API\u00a0<\/span>(<a class=\"ocpExternalLink\" href=\"https:\/\/learn.microsoft.com\/graph\/outlook-create-send-messages\" target=\"_blank\" rel=\"noopener\" data-bi-type=\"anchor\">Automate creating, sending, and processing messages using the Outlook mail API &#8211; Microsoft Graph | Microsoft Learn<\/a>).<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>Retirement of the SharePoint SendEmail API from SharePoint Online &#8211; impacting both REST and CSOM API surfaces.<\/p>\n","protected":false},"author":69078,"featured_media":23312,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[166],"tags":[138,366,65,162,367],"class_list":["post-23308","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-sharepoint","tag-apis-2","tag-csom","tag-power-automate","tag-sharepoint","tag-workflow"],"acf":[],"blog_post_summary":"<p>Retirement of the SharePoint SendEmail API from SharePoint Online &#8211; impacting both REST and CSOM API surfaces.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/23308","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69078"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=23308"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/23308\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/23312"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=23308"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=23308"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=23308"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}