How do I send email from an SPFx web part?

Request the Microsoft Graph Mail.Send permission in package-solution.json, have an admin approve it in API access, then call client.api('/me/sendMail').post({ message }) with MSGraphClientV3 from this.context.msGraphClientFactory.getClient('3'). Graph returns 202 Accepted.

Does PnPjs sp.utility.sendEmail still work?

No. It calls SharePoint's SendEmail API, which Microsoft retired on 10/31/2025 ( retirement notice ). In our test it returned HTTP 400 with "The SendEmail api has been retired." Use Microsoft Graph instead.

What permission does POST /me/sendMail need?

The delegated Mail.Send permission; there's no lower-privileged option. The Microsoft Graph sendMail reference lists the request body and the 202 Accepted response.

How do I set up PnPjs v4 in SPFx?

Import spfi and SPFx from @pnp/sp, then in onInit (after await super.onInit()) create one instance with spfi().using(SPFx(this.context)). For Graph, use graphfi().using(SPFx(this.context)) from @pnp/graph. Don't use sp.setup() or @pnp/sp/presets/all.

Why do guest users get "The mailbox is either inactive, soft-deleted, or is hosted on-premise"?

Because /me/sendMail sends from the signed-in user's own Exchange Online mailbox, and a guest has none in your tenant. Send through a Power Automate flow or an app-only service instead, or license the user.

Send Email in SPFx: Microsoft Graph sendMail and PnPjs

Our operations team asked for a small “Notify the warehouse” form on their SharePoint home page: type a few lines, press one button, and the email leaves from the person who pressed it. I reached for the PnPjs sp.utility.sendEmail() snippet I’d used in SharePoint Framework web parts for years.

It doesn’t work anymore. Microsoft retired the SharePoint SendEmail API on 10/31/2025, and today the same call comes back with a 400 error instead of an email. The replacement is Microsoft Graph, which sends from the signed-in user’s own mailbox.

In this tutorial, we’ll build a React web part that can send email in SPFx both ways: Microsoft Graph /me/sendMail through MSGraphClientV3, and the old PnPjs method, so you can see exactly what it returns now. We’ll also fix the “mailbox is either inactive, soft-deleted, or is hosted on-premise” error that guest users hit.

Quick answer: Add { "resource": "Microsoft Graph", "scope": "Mail.Send" } to webApiPermissionRequests in config/package-solution.json and have an admin approve it under SharePoint admin center > Advanced > API access. In code, get this.context.msGraphClientFactory.getClient('3') and call client.api('/me/sendMail').post({ message, saveToSentItems: true }). Graph answers 202 Accepted. Don’t use PnPjs sp.utility.sendEmail(): the SharePoint SendEmail API behind it was retired on 10/31/2025.

Here’s the finished web part after a successful send from the SPGuides site workbench:

SPFx Send Email web part sending a test email with Microsoft Graph sendMail and showing 202 Accepted

Tested with	Version
SharePoint Framework (SPFx)	1.23.2 with the Heft toolchain
Node.js	22 LTS
React / Fluent UI	17.0.1 / @fluentui/react 8
PnPjs	@pnp/sp 4.22.0
Graph client	MSGraphClientV3 from @microsoft/sp-http 1.23.2

Table of Contents:

Which Way Should You Send Email from SPFx in 2026?

There are three realistic options, and only one of them runs inside the web p