How to link your email

Link your mailbox once and BillBetter.AI checks it every few minutes. Emails carrying a bill — a PDF, a photo, or a billing-style message — are read and recorded for your review. Marketing and newsletters are ignored.

Everything happens under Email in the app's top menu.

Outlook / Microsoft 365 / Hotmail

  1. In the app, open the Email tab and choose Microsoft 365 / Outlook.
  2. Click Sign in with Microsoft. A short code appears on the screen (something like ABC-DEF-123).
  3. Go to microsoft.com/devicelogin — the page opens in a new tab — and type in that code.
  4. Sign in with the email account you want to link and approve the access request.
  5. Come back to the BillBetter.AI tab. Within a few seconds it flips to "Linked via Microsoft 365" on its own. Done.
Your password stays with Microsoft — BillBetter.AI only receives a limited permission to read your mail, which you (or your IT admin) can revoke at any time from your Microsoft account settings.

Gmail

Google requires a special App Password for mail apps — your normal password won't work. Two minutes, one time:

  1. Make sure 2-Step Verification is on for your Google account: myaccount.google.com/security. (App Passwords only exist when it's on.)
  2. Go to myaccount.google.com/apppasswords and sign in.
  3. Under "App name" type BillBetter and click Create. Google shows a 16-letter password — copy it (spaces don't matter).
  4. In the app's Email tab choose Gmail / other IMAP and fill in:
    IMAP server: imap.gmail.com
    Email address: your Gmail address
    Port: 993
    Password: the 16-letter App Password from step 3
  5. Click link — the status card appears and the first check runs within a couple of minutes.
An App Password only lets an app read mail over IMAP. You can revoke it any time on the same Google page without changing your real password.

Any other email provider

Use the Gmail / other IMAP option with your provider's settings — search the web for "your provider IMAP settings". You need three things: the IMAP server address (e.g. imap.mail.yahoo.com), port 993, and your password (some providers, like Yahoo and AOL, also use app passwords — their security pages have a "generate app password" option).

What happens after linking

  1. Set your start date. On the Email tab, "Only read emails received on or after" controls how far back BillBetter.AI reads — set it to today if you only want new bills.
  2. Bills record themselves. Emails with a bill attached (or billing-style receipts like a phone bill) are read — biller, amount, due date — and appear in your Bills as pending, with the document attached.
  3. Unsure ones wait for you. Anything the reader isn't confident about lands in the Review inbox at the bottom of the Email tab, where one click records or dismisses it.
  4. Sent mail is optional. Tick "Also read my Sent mail" if you email invoices out and want them recorded as sent bills.

If something doesn't work

"Sign-in failed" with Microsoft — the code may have expired (they last ~15 minutes); click Sign in with Microsoft again for a fresh one.

Gmail says the password is wrong — make sure you're pasting the 16-letter App Password, not your normal password, and that 2-Step Verification is on.

Linked, but no bills appear — check the start date isn't set to a future day, then press Check now. The status line under "Linked mailbox" reports what the last check found.

Still stuck? Reach us via the Support page.