Configuration 

This section covers all aspects of configuring the Microsoft Exchange 365 Mailer extension for TYPO3.

After completing the Azure Configuration, you need to configure the TYPO3 extension with the values obtained from Microsoft Entra ID.

Quick Configuration Overview 

The extension requires the following key configuration variables:

  1. Mail Transport: Set to use Exchange365Transport
  2. Tenant ID: Your Microsoft Entra ID tenant identifier
  3. Client ID: Your Azure application identifier
  4. Client Secret: Your Azure application secret
  5. From Email: The sender email address
  6. Graph Sender User ID (optional): Mailbox used for the Microsoft Graph /users/{id}/sendMail call. Decouples the Graph mailbox from the visible From header for Send As / Send On Behalf scenarios.
  7. Save to Sent Items: Whether to save emails to sent folder

For detailed step-by-step instructions, see:

Configuration Methods 

You can configure this extension using:

Essential Configuration (Recommended)
  • $GLOBALS['TYPO3_CONF_VARS']['MAIL'], filled from environment variables
  • Applies to backend, CLI, scheduler and frontend
Site Set (TYPO3 v13 and v14, for Forms)
  • Activated per site, edited in Site Management > Sites
  • The modern replacement for the static TypoScript template
Frontend Configuration (TypoScript, all versions)
  • Optional per-site overrides via the static template
  • Read secrets with := getEnv(...) — never write them into TypoScript

Choose the method that best fits your deployment workflow and security requirements.

Configuration Precedence 

The two sources are merged per setting, not all-or-nothing:

  1. The global mail settings ($GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport_exchange365_*']) are the baseline and apply in every context — frontend, backend, command line and scheduler.
  2. In the frontend, any non-empty value from the site set or from TypoScript overrides the corresponding mail setting. Values left empty fall through to the baseline.

This lets you keep the credentials in environment variables while still adjusting, for example, fromEmail per site in the backend.