Setting up an E-mail Data Source

How to create an App password for Gravity to connect to and extract data from a mailbox

An app password is a code that gives an app - in this case, Gravity - or device permission to access your mailbox(es) without having to share the password you use to access your mailbox. You can revoke this app password at any time.

We've included the steps to do this for 4 popular email providers.

What you'll need

  • Permissions to access and change security settings** for the mailbox

  • 2 factor/multi-factor authentication enabled on the account

** Depending on the email provider e.g. Microsoft, Google, Yahoo! and Apple and your company's security policies and procedures, you may not need to request or have any permissions granted to do this.


Google Mail

  1. On the left navigation panel, click on Security

  2. On the Signing into Google panel, click App Passwords. If you don’t see this option:

    1. 2-Step Verification is not set up for your account

    2. 2-Step Verification is set up for security keys only

    3. Your account is through work, school, or other organization

    4. You’ve turned on Advanced Protection for your account

  3. At the bottom, click Select app and choose the Google Mail** app

  4. Click Select device and choose Other**, then enter a memorable description e.g. Gravity Email Data Source

  5. Click Generate. The App Password is the 16-character code in the yellow boxes

** Option name may vary

In some cases, Google may restrict using App Passwords because your Google Account is not set up to use less secure apps. To enable them:

  1. Go to the Less secure app access ( section of your Google Account after signing in

  2. Turn Allow less secure apps on

  3. Repeat app password creation steps above

Yahoo! Mail

  1. Click Generate app password or Manage app passwords

  2. Select your app from the drop-down menu and click Generate

Office 365

  1. Sign into Office 365 and go to the My Account page

  2. Go to Security & Privacy > Additional security verification. If you don't see this option, you’ll need to turn on multi-factor authentication

  3. Click Update my phone numbers used for account security

  4. At the top of the page, click App Passwords

  5. Click create to get an app password. If prompted, type a name for your app password, and click Next


  1. Navigate to Apple ID ( from your web browser and sign in with your Apple ID and Password

  2. Verify your identity with two-factor authentication

  3. Under the security section, select generate passwords

  4. Enter a memorable label for the password e.g. Gravity Email Data Source

  5. Click Create

Last updated