AdSpirit supports email sending via SMTP and modern authentication methods such as OAuth 2.0. There are various configurations available: Standard SMTP, Gmail with App Password, Gmail OAuth 2.0 for businesses, and Microsoft 365 OAuth 2.0. Admin rights are usually required for OAuth, and changes may take time to take effect. Important settings include sender address, SMTP host, port, and authentication type.
AdSpirit supports email sending via SMTP as well as modern authentication methods (OAuth 2.0).
Several configuration options are available:
- Standard Configuration (SMTP)
- Gmail App Password
- Gmail OAuth 2.0
- Microsoft 365 OAuth 2.0
PATH: Settings -> Global Settings -> Company Data -> Configuration
1. Standard SMTP Configuration
This method uses classic SMTP credentials.
Configuration
- Sender Address: Your own email address
- Username: Email username
- Password: Email password
- SMTP Host: smtp.office365.com
- SMTP Port: 0
- Encryption: tls
- Authentication Type: AdSpirit Default Configuration
Then save the settings.
Detailed instructions can be found here: Setting Up Your Own SMTP Server for Email Sending
2. Gmail with App Password
This method is suitable for Gmail accounts (personal or Google Workspace).
Prerequisites
- Two-factor authentication (2FA) is enabled
Setup
- Enable two-factor authentication in your Google account
- Create an app password:
- App: Mail
- Device: freely selectable (e.g., “Mailer”)
- Copy the generated password
Configuration in AdSpirit
- Sender Address: same as username
- Password: App password
- SMTP Host: smtp.gmail.com
- SMTP Port: 587
Save the settings.
- Direct link to app passwords: https://myaccount.google.com/apppasswords (Note: Requires logged-in Google account and active two-factor authentication)
- Official guide: Signing in with app passwords (https://support.google.com/accounts/answer/185833)
3. Gmail OAuth 2.0 (Recommended for Businesses)
Prerequisites
- Google Workspace account
- Super admin access
Step 1: Create Service Account
- Open Google Cloud Console
- Create a new project (if necessary)
- Enable Gmail API
- Create service account
- Enable domain-wide delegation
- Create and download JSON key
Step 2: Admin Approval
- Open Google Admin Console
- Navigate to “Security → API Controls → Domain-wide Delegation”
- Add new delegation
Enter:
- Client ID: from the service account
- OAuth Scopes:
https://mail.google.com/ https://www.googleapis.com/auth/gmail.send
Changes may take some time to take effect.
Step 3: Configuration in AdSpirit
- Authentication Type: Gmail OAuth 2.0
- Upload JSON file
- Google Cloud Console: https://console.cloud.google.com/
- Service Account Guide: Creating and managing service accounts (https://docs.cloud.google.com/iam/docs/best-practices-service-accounts?hl=de)
- Domain-wide Delegation: Domain-wide delegation of authority (https://knowledge.workspace.google.com/admin/apps/control-api-access-with-domain-wide-delegation?hl=de)
4. Microsoft 365 OAuth 2.0
Step 1: Register App
- Open Microsoft Entra Admin Center
- Register new app
- Tenant: Single Tenant
Step 2: Obtain Tenant ID
- Entra ID → Overview
- Copy Tenant ID
Step 3: Set Permissions
- Add API permissions
- Select Office 365 Exchange Online
- Permission: SMTP.SendAsApp
- Grant admin consent
Step 4: Create Client Secret
- Open Certificates & Secrets
- Create new secret
- Save value immediately
Step 5: Enable SMTP AUTH
- Open Microsoft 365 Admin Center
- Select user
- Mail → Manage email apps
- Enable Authenticated SMTP
Step 6: (Optional) Send-As Permission
Add-RecipientPermission -Identity "noreply@company.com" -Trustee "<App>" -AccessRights SendAs
Step 7: Configuration in AdSpirit
- Client ID
- Client Secret
- Tenant ID
- SMTP Server: smtp.office365.com
- Port: 587
Save the settings.
- Microsoft Entra Admin Center: https://entra.microsoft.com/
- Enable SMTP AUTH: Setting up SMTP AUTH in Exchange Online (https://learn.microsoft.com/de-de/exchange/clients-and-mobile-in-exchange-online/authenticated-client-smtp-submission)
- Microsoft Graph API Documentation: Sending mail via Microsoft Graph (https://learn.microsoft.com/de-de/graph/api/user-sendmail?view=graph-rest-1.0&tabs=http)
If you encounter problems, it might be due to:
- OAuth configurations usually require admin rights
- Changes may take some time to become active
- Check the following if problems occur:
- SMTP AUTH is enabled
- Permissions are set correctly
- Credentials are entered correctly