Skip to main content

Gmail

Gmail can be connected two ways: a quick app password setup, or a full OAuth connection using your own Google Cloud credentials.

Option 1: App password (Custom)​

  1. When creating or editing a brand, select Custom as the email provider instead of Gmail.
  2. Enter your Gmail address and fill in Gmail's SMTP/IMAP host and port details.
  3. Continue to the next page and enter your Google app password.

Getting a Google app password​

You'll need 2-Step Verification turned on for your Google Account first. Once that's on:

  1. Go to Google App Passwords.
  2. Enter a name (e.g. "Aimly") and click Generate.
  3. Copy the 16-character app password — Google only shows it once.

Paste that password into Aimly's app password field to complete the connection.

Option 2: OAuth (Gmail provider)​

Selecting Gmail directly (instead of Custom) uses full OAuth sign-in instead of an app password, but requires you to bring your own Google API credentials first.

  1. Create OAuth credentials in the Google Cloud Console:
    • Create or select a project.
    • Enable the Gmail API under APIs & Services → Library.
    • Under APIs & Services → Credentials, create an OAuth client ID.
    • Choose Desktop app (or Web application, depending on your setup) as the application type.
    • Download the resulting file — this is your credentials.json.
  2. In Aimly, select Gmail as the provider and upload your credentials.json.
  3. Aimly opens a new tab for Google's OAuth sign-in.
  4. Sign in and approve access.

Once approved, control returns to Aimly and your Gmail mailbox is connected via OAuth.