AcyMailing
Our siteForumBlog
Latest version
Latest version
  • AcyMailing documentation
  • How to renew AcyMailing license?
  • How to switch AcyMailing license plan?
  • Setup AcyMailing
    • Update from AcyMailing 5
    • Installation
      • Download AcyMailing
      • Install AcyMailing
      • Update AcyMailing
      • Switching from Starter to a paid version
      • Uninstall AcyMailing
    • Move AcyMailing between websites
      • Migrate between Joomla! and WordPress
      • Move between two WordPress websites
      • Switch from Joomla 3 to Joomla 4/5
    • Configuration
      • License
      • Mail settings
        • Set up your DKIM : DomainKeys Identified Mail
        • Set up Oauth 2.0
      • Queue process
      • Configure your send process
      • Subscription
      • Bounce handling
      • Data collection
      • Security
      • Languages
    • Step by step guide
    • Multilingual websites
      • Translate AcyMailing
      • Custom translation
    • Subscription to your lists
      • Subscription form - Joomla
      • Subscription form - WordPress
      • Other subscription methods
      • RSForm!Pro integration
  • External sending methods
    • AcyMailing Sending Service
    • Amazon SES
    • ElasticEmail
    • Mailgun
    • Postmark
    • SendGrid
    • Brevo SMTP Relay
    • Brevo / Sendinblue (Legacy)
  • Main pages
    • Dashboard
    • Subscription forms
      • Subscription Form
      • Header
      • Footer
      • Popup
      • Shortcode (Wordpress)
    • Subscribers
      • Create a subscriber
      • Import subscribers
      • Export subscribers
    • Custom fields
      • Create Custom Field
      • Examples
    • Lists
      • Create a list
    • Segment
      • Edition
    • Emails
      • Creation of a campaign
        • Choose a template
        • Edit email
        • Recipients
        • Segment
        • Send settings
        • Tests
        • Summary
      • A/B testing
      • Automatic campaigns
      • Follow-up
        • Trigger
        • Condition
        • Emails
        • Summary
      • Special mails
    • The email editor
      • Tenor integration
      • Unsplash integration
    • Templates
      • Create a template
      • Import a template
    • Email overrides
      • Edition
    • Automations
      • Information
      • Conditions
      • Actions
      • Action targets
      • Summary
    • Scenario
      • Create a new Scenario
      • Performances
    • Queue
    • Statistics
      • Overview
      • Detailed Statistics
      • Click map
      • Links details
      • User click details
      • Statistics per list
    • Add-ons
    • Mailbox actions
      • Mailbox actions
        • Edition
      • Bounce rules
        • Configuration
        • Listing
        • Create bounce rules
  • Advanced
    • Send follow-up messages based on subscription
    • Let site users use AcyMailing
      • List management
      • User management
      • Campaigns management
    • Show an archive of the sent newsletters
    • Show a profile edition form on your site
    • Partner platform
      • Log in
      • Dashboard
      • Single domain details
  • Integrations
    • Settings
    • Joomla add-ons
      • Joomla articles
      • CB Subscriptions
      • Community Builder
      • Community Quiz
      • Community Surveys
      • Contacts
      • Dashboard Quick icon
      • Docman
      • DPCalendar
      • EasyBlog
      • EasyProfile
      • EasySocial
      • Event Booking
      • FLEXIcontent
      • HikaShop
      • iCagenda
      • JCal Pro
      • jDownloads
      • JEvents
      • JSW CRM
      • JTicketing
      • K2 Content
      • Membership Pro
      • Module
      • PayPlans
      • Phoca Download
      • RSEvents!Pro
      • Seblod
      • Shika
      • VirtueMart
      • Zoo
    • WordPress add-ons
      • WordPress posts and pages
      • Advanced Custom Fields (ACF)
      • Business Directory
      • Contact Form 7
      • Easy Digital Downloads
      • EventON
      • Events Manager
      • Gravity Forms
      • Learndash
      • MemberPress
      • Modern Events Calendar
      • The events calendar
      • Ultimate Member
      • Uncanny Automator
      • WooCommerce
    • All websites add-ons
      • Articles, posts and pages from WordPress and Joomla
      • Automation - export action
      • Create user
      • Custom headers
      • RSS and Atom feeds
      • Table of contents generator
      • Universal filter
    • Zapier
  • Developers
    • Developer Documentation
    • Making a custom add-on
      • Execute custom script on specific AcyMailing actions
      • Insert a dynamic text in an email for Joomla
      • Insert a custom block in an email for Joomla
      • Insert a dynamic text in an email for WordPress
      • Insert a custom block in an email for WordPress
    • Custom script using our code
    • Create a page override
    • Joomla quickstart package with AcyMailing
    • Customise inserted content
  • FAQ
    • Could not instantiate mail function - AcyMailing
    • Spam issue
    • Your send process is slow?
    • Compatibility issues
    • Mail archive not displaying special characters
Powered by GitBook
On this page
  • Gmail
  • Outlook
  1. Setup AcyMailing
  2. Configuration
  3. Mail settings

Set up Oauth 2.0

PreviousSet up your DKIM : DomainKeys Identified MailNextQueue process

Last updated 22 days ago

Recently Google and Microsoft changed their authentication method to send e-mails

With both you can either use the OAuth (method 2) authentification or the user/password (method 1), but note that the user/password and not the credentials you use to connect to your mailbox but application password that need to be created.

Gmail

First make sure to be admin on your Google account, then follow these steps to generate your credentials:

  • Go to the dashboard and select a project (or create a new one)

  • Go to APIs and services => Library, search for Gmail API and enable it

  • On the overview page, click the Create credentials button (if this is not available, so to the APIs and services => Credentials menu)

  • You can skip the scope section by clicking the Save and continue button

  • Select Web application, then in the Authorised redirect URIs section, add the Redirect URL that is shown in your AcyMailing configuration page. Note that it may differ if your administration URL has been customised: - https://www.example.com/administrator/ for Joomla websites - https://www.example.com/wp-admin/ for WordPress websites

  • Go to OAuth consent screen, then to Audience and make sure your app is "External". If you need to switch it from "Internal" to "External", select the "In production" option in the popup.

  • You can then either publish your app, or add your email address as a test user. We will use the first method in this example to have permanent credentials.

  • Go to the Clients menu then click the pencil to reveal your credentials

  • Copy your Client ID and Client secret then paste them in your AcyMailing configuration, then configure the connection to your mailbox.

Select the Google sending method, then fill in the required information. The username is typically your email address:

  • Username: your email address

  • Client id: the Client ID you copied

  • Client secret: the Client secret key you copied

The typical configuration for a connection with a Gmail account uses the following values:

  • Bounce email address: your email address

  • Server: imap.gmail.com

  • Username: your email address

  • Client id: the Client ID you copied

  • Client secret: the Client secret key you copied

  • Once the fields are set, click the Authenticate button then select your Google account

  • Google will show a warning because your app hasn't been verified. This is normal, you can click the Advanced link at the bottom-left, then Go to example.com (unsafe) to be redirected to the consent screen.

  • Finally, click the Continue button to allow your app to connect to your email address

You should then be redirected to your website and a confirmation should be shown if everything worked correctly:

Outlook

  • Search for App registrations and select it, then create a New registration

  • You can name it how you prefer

  • Select Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)

  • In the Redirect URI part, select Web then copy and paste the Redirect URL shown in your AcyMailing configuration (usually your website's admin URL)

  • Click the Register button to confirm the creation

  • Copy the Application (client) ID, it is the first part of your credentials so you will need to copy it in your AcyMailing configuration. You can always find it under the Overview menu.

  • You can now create the second par of your credentials, visit the Certificates & secrets menu and click the New client secret button

  • You will be able to choose when these credentials expire (from 6 months to 24 months). Note that you will need to create new credentials here once they expire, and add them into AcyMailing again.

  • Click the Add button

  • Copy the value on the next page, this is your Client secret. It is shown only once, if you didn't copy it you can always create a new one.

  • Your credentials are ready, you can now add them in the AcyMailing configuration:

Select the Outlook sending method, then fill in the required information. The username is typically your email address:

  • Username: your email address

  • Tenant: In most cases, you can select Any account type

  • Client id: the Application ID you copied

  • Client secret: the Client secret value you copied

Before adding your information in AcyMailing, you will need to add some permissions to your Microsoft app:

  • Go to API Permissions

  • Click on Add a permission

  • Select Microsoft Graph

  • Select Delegated permissions

  • Search for IMAP and select IMAP.AccessAsUser.All

  • Search for offline and select offline_access

You should have the following permissions configured:

If you have a personal email address, you will also need to authorise the IMAP connection by your app in your mailbox settings:

The typical configuration for a connection with a Microsoft account uses the following values:

  • Bounce email address: your email address

  • Server: outlook.office365.com

  • Username: your email address

  • Tenant: In most cases, you can select Any account type

  • Client id: the Client ID you copied

  • Client secret: the Client secret key you copied

  • Once the fields are set, click the Authenticate button. You will be redirected to the Microsoft account selection.

  • On the next page, click the Accept button

  • Once done, you should be redirected to your website with a confirmation message:

Sign in to the

Azure portal
Google cloud console