ContextQMD
Back to Symfony

MAILER

src/Symfony/Component/Mailer/Bridge/MicrosoftGraph/README.md

8.0.92.0 KB
Original Source

Microsoft Graph API Mailer

Provides Microsoft Graph API Email integration for Symfony Mailer.

Prerequisites

You will need to:

  • Register an application in your Microsoft Azure portal,
  • Grant this application the Microsoft Graph Mail.Send permission,
  • Create a secret for that app.

Configuration example

env
# MAILER
MAILER_DSN=microsoftgraph+api://CLIENT_APP_ID:CLIENT_APP_SECRET@default?tenantId=TENANT_ID

This will default to graph.microsoft.com for the Graph API and login.microsoftonline.com for authentication.

If you need to use third parties operated or specific regions Microsoft services (China, US Government, etc.), you can specify the Graph Endpoint and the Auth Endpoint explicitly.

env
# MAILER e.g. for China
MAILER_DSN=microsoftgraph+api://CLIENT_APP_ID:[email protected]?tenantId=TENANT_ID&authEndpoint=login.partner.microsoftonline.cn

The exact URLs can be found in the Microsoft documentation:

You can also specify to not save the messages to sent items using the noSave parameter:

env
# MAILER
MAILER_DSN=microsoftgraph+api://CLIENT_APP_ID:CLIENT_APP_SECRET@default?tenantId=TENANT_ID&noSave=true

Troubleshooting

Beware that the sender email address needs to be an address of an account inside your tenant.

Resources