Microsoft 365 Connect

This is the recommended way for Microsoft 365: just sign in with the mailbox and authorize. You do not need to register applications in Azure, nor a Client Id, Client Secret or Tenant Id, and there are no secrets to renew.

If your organization has in-house IT that wants to keep control over the setup, it can use Microsoft 365 OAuth2 instead.

⚙️ Setup in GC

Go to Administration >> Email >> Sending Accounts, click Add and choose the Microsoft 365 Connect type.

  1. Fill in E-Mail: From (the address of the mailbox that will send) and Name, and save.
  2. Click Consent. The Microsoft sign-in opens in a new window:
    • sign in with the mailbox that will send;
    • review the permissions requested by the SolidSoft application and click Accept.
  3. At the end, “Consent completed for mailbox …” appears. Close the window.
  4. Click Test.

Emails now go out directly from your Microsoft 365 mailbox and are kept in Sent Items. It does not depend on “Authenticated SMTP” being turned on in Microsoft 365.

🏢 If your organization requires administrator approval

Some organizations only allow applications approved by an administrator to be connected. In that case, the consent page explains this and shows the link “Aprovar para a organização (administrador do Microsoft 365)” (approve for the organization, as the Microsoft 365 administrator):

  1. Send that link to your organization’s Microsoft 365 administrator (or open it with their account).
  2. The administrator signs in, reviews the permissions and approves for the whole organization.
  3. After that, the mailbox is connected; if it is not, click Consent again in GC.

❓ Frequently asked questions

  • The sender (E-Mail: From) is different from the mailbox I signed in with. Emails only go out if that mailbox has permission to send as that address (for example, a shared mailbox). The consent page warns you when this happens.
  • How do I remove access? In your organization’s Microsoft Entra portal, under Enterprise applications, remove the SolidSoft application. After that, sending stops until you give consent again.
  • I changed the Microsoft account password. It normally keeps working; if the test fails, give Consent again.