Emails

SMTP

Availability: Business as a paid add-on

How to set up your custom SMTP: 

1. Switch the SMTP Enabled toggle on

2. Fill in the required information

3. If you want to test the configuration, enter your email address and click Test SMTP

Setting up SMTP with Microsoft Graph API

SMTP can be accessed via Modern Authentication set up in Microsoft Entra ID (formerly Microsoft Azure Active Directory), which uses tokens to access the SMTP from Circularo.

1. The client need to set up a Circularo application in Entra ID (Guide on registering an app in Entra ID)

2. Sign in to the Azure Portal

   • Open the Azure Portal and log in with your credentials.

3. Access Azure Active Directory

   • From the left-hand menu, select Microsoft Entra ID

4. Create a New Application

   • Navigate to App registrations

   • Click + New registration

   • Enter a name for the application and click Register

5. Configure the Application

   • From the left-hand menu select Manage → API Permissions

   • Click Add permission

   • In the pop-up window select Microsoft Graph → Application Permissions

   • Search for Mail.Send permission and add it
     (NOTE: Once the API permission is added, the tenant admin needs to grant their consent by clicking Grant admin consent for <directory_name>)

6. Create Client Secret

   • From the left-hand menu select Certificates & secrets

   • Click New client secret

   • Choose preferred secret expiration and give the secret a name
     (NOTE: When the secret expires, new secret needs to be generated and entered in Circularo)

   • Click Add

   • Copy the Value of the secret
     (NOTE: The secret value is displayed only once during the creation of the secret, if you don’t manage to copy it, you will need to create a new secret)

7. Configure credentials in Circularo

   1. Navigate to the organization settings

   2. Under Emails (or Emails → Settings for super admin) enable the SMTP enabled toggle

   3. From the Mailing provider dropdown select Microsoft graph API

   4. Fill in the following details:

      1. Sender email → Email of the service account that will be used to send Circularo notifications

      2. Client ID → Can be found in the Azure app registration under Overview as Application (client) ID

      3. Client Secret → The secret value that we copied earlier

      4. Access URL → Can be found in the Azure app registration under Overview → Endpoints as OAuth 2.0 token endpoint (v2)

8. Once all the details are configured, you can fill in your own email in the Email address field and send a test email, if everything was configured properly, you should receive the Success message