Aurorafinance← Back to Aurora

Help / Email importing

Forward receipts from Gmail

Automatically send receipts to Aurora with Gmail filters. Follow the steps below to add your address, confirm it, and choose which emails to forward.

Set up on a computerYou choose what gets forwarded

Select any image to view it full size. Personal details are hidden.

Before you start

Keep Gmail and Aurora open in separate browser tabs.

  1. Use Gmail on a computer

    Forwarding and filter settings are available in Gmail on the web, not in the Gmail mobile app. Sign in to the Google account that receives your receipts.

  2. Check your sending address in Aurora

    Your Aurora sign-in email is already accepted. If you forward from another address, add and confirm it in Settings → Import → Forwarding addresses.

  3. Copy your Aurora import address

    Open Settings → Import in Aurora and copy your import address. You will paste it into Gmail in the next section.

Add Aurora as a forwarding address

First, tell Gmail where to send your receipts.

Forward only the mail you choose

Leave “Forward a copy of incoming mail” turned off. The filters you create in section 4 will forward matching receipts without forwarding your entire inbox.

  1. Open Gmail’s forwarding settings

    Click the Settings gear → See all settings → Forwarding and POP/IMAP.

    Gmail Settings with the Forwarding and POP/IMAP tab selected. The Forwarding row shows the Add a forwarding address button.
    View full size
    Open the forwarding tab and choose Add a forwarding address.

  2. Add your Aurora import address

    Click Add a forwarding address and paste the address you copied from Aurora. Click Next, then Proceed if Gmail asks you to confirm.

    Gmail's Add a forwarding address dialog with the Aurora import address entered — import-, a hidden token, @in.aurorafinance.app — and the Next button.
    View full size
    Paste the import address you copied from Aurora.

  3. Complete Google’s security check, if asked

    Google may ask you to verify your identity. Follow the instructions in the Google window; the options may differ from the example below.

    See an example of Google’s security check
    Google's Verify it's you window, saying Google wants to make sure it's really you trying to set up forwarding in Gmail, with the account (hidden), a recovery phone notice and a Get code button.
    View full size
    Google may ask you to verify your identity before continuing.

Screens checked on 2026-10-04

Confirm the forwarding address

Confirm the address before creating any filters.

  1. Find Google’s confirmation

    Aurora shows the confirmation in the setup assistant (step 2) and also sends it to your Aurora sign-in email. If you use different addresses for Aurora and Gmail, check your Aurora sign-in inbox.

  2. Confirm with Google

    Open the confirmation link from the assistant or click Confirm in Gmail in the email. On Google’s page, click Confirm. You must complete this step yourself.

    Aurora's Confirm Gmail forwarding email: the requesting address (hidden) asked Gmail to forward mail to your Aurora import address, with a Confirm in Gmail button and a link to this guide.
    View full size
    Use the confirmation sent to your Aurora sign-in email.

  3. If the email has not arrived

    Wait a few minutes, then click Resend email beside the Aurora address in Gmail’s forwarding settings.

Screens checked on 2026-10-04

Create your receipt filters

A filter tells Gmail which emails to forward. Start with the filter file from Aurora.

  1. Choose what to forward and download the file

    In the setup assistant, English receipts are suggested first. Add other receipt languages, specific senders, or statements as needed. Click Download filter file.

  2. Open Gmail’s filter settings

    In Gmail, go to Settings → See all settings → Filters and Blocked Addresses. Click Import filters.

    Gmail Settings with the Filters and Blocked Addresses tab selected, showing the Create a new filter and Import filters links.
    View full size
    Choose Import filters on the Filters and Blocked Addresses tab.

  3. Choose the downloaded file

    Click Choose File and select the filter file you downloaded from Aurora, usually in your Downloads folder.

    Gmail's Import Filters panel: First, choose the file containing filters, then click the Open file button, with Choose File and Open file.
    View full size
    Choose the filter file downloaded from Aurora.

  4. Open the file in Gmail

    Once the filename appears beside Choose File, click Open file. This displays the filters for review; it does not create them yet.

    The Import Filters panel after choosing mailFilters.xml, with the Open file button now enabled.
    View full size
    When the filename appears, select Open file.

  5. Review and create the filters

    Check that each selected filter says Forward to your Aurora import address. Then click Create filters. Skip the Inbox is optional and off by default, so your receipts stay in your Gmail inbox too.

    Gmail lists the filter to import — Matches: the subject query; Do this: Forward to the Aurora import address (token hidden) — with the Create filters button.
    View full size
    Check the forwarding destination, then choose Create filters.
Prefer to create filters manually?

For each filter in the assistant, open See what this catches. In Gmail, click the search options icon → Create filter → select Forward it to → choose your Aurora address → Create filter.

Screens checked on 2026-10-04

Check your setup

Use Gmail to check the settings, and Aurora to check incoming imports.

  1. Check the forwarding address

    In Forwarding and POP/IMAP, check that your Aurora import address is confirmed.

  2. Check the filter list

    Open Filters and Blocked Addresses. Each Aurora filter should show Forward to your import address. Its query includes -from:aurorafinance.app; a statement filter also starts with from: and the selected bank domains.

    Gmail's filter list showing the created filter: Matches the subject query, Do this: Forward to the Aurora import address (token hidden), with edit and delete links.
    View full size
    Your filter now appears in Gmail, with edit and delete controls.

  3. Check incoming receipts in Aurora

    After a new email matches one of your filters, open Aurora’s Import history to check its progress or review any error.

Screens checked on 2026-10-04

Change or stop forwarding

Manage the filters in Gmail whenever your needs change.

  1. Replace a filter

    Edit the filter in Aurora’s setup assistant and download the updated file. In Gmail, delete the old version of that filter, then import the new file. Importing a file does not update an existing filter.

  2. Stop forwarding to Aurora

    Delete Aurora’s filters under Filters and Blocked Addresses. Then remove the Aurora address under Forwarding and POP/IMAP.

  3. No Gmail connection to revoke

    Aurora does not have access to your Gmail account. Gmail sends only the messages selected by your forwarding rules.

Troubleshooting

Start with the issue you are seeing.

  1. The confirmation email is missing

    Check the inbox for your Aurora sign-in email, which may differ from the Gmail address you are setting up. Then use Resend email in Gmail’s forwarding settings.

  2. “Add a forwarding address” is missing

    If a direct link shows an empty forwarding box instead, return to Gmail’s Inbox. Open the Settings gear → See all settings → Forwarding and POP/IMAP again.

  3. Nothing is being imported

    Confirm your sending address in Aurora. In the assistant, use See what this catches to check the filter. Also check that the destination ledger has an account.

  4. Forwarding is disabled for a work account

    Your Google Workspace administrator may have disabled automatic forwarding. Ask them whether forwarding is allowed.

  5. An email arrived but the import failed

    Open Import history in Aurora. The failed import includes the reason and any next steps.

What Aurora does with forwarded mail

You control what Gmail sends to Aurora.

  1. Receipts and statements become transactions

    Aurora reads forwarded receipts and statements to create transactions. Forwarded files are kept for a limited time, then deleted.

  2. Keep your filters specific

    Forward only the receipts and statements you want to import. Review the privacy policy for details about how Aurora handles your data.

Privacy policy

Ready to set up forwarding?

The setup assistant keeps your address and filter file in one place.

Open the setup assistant