Overview

Stareceipt supports two independent ways to import receipt and invoice emails:

Connected Gmail: authorize read-only access to a Gmail mailbox, select a workspace, and let Stareceipt find likely receipts automatically.
Email forwarding: bind and verify a receiving email, then send or automatically forward messages to upload@stareceipt.com. Use this with any provider or when you prefer not to connect a mailbox.

Connecting Gmail is separate from signing in to Stareceipt. Connecting or disconnecting a mailbox never adds, removes, or changes a Stareceipt login method.

Connect Gmail

Open Settings → Receiving Emails.
Under Connected mailboxes, choose Connect Gmail.
Select the workspace that should receive extracted expenses and choose a 30-, 90-, or 365-day initial backfill.
Continue in the system browser, choose the Google account, and review Google's consent screen.
Return to Stareceipt. The connection may take a few moments to finish its first synchronization.

Stareceipt requests read-only Gmail access. It cannot send, edit, or delete messages. The connected Google account may be different from the email address you use to sign in to Stareceipt.

Control what is imported

The connected-mailbox settings let you choose the destination workspace and a receipt filter preset. Stareceipt uses inbox status and receipt-like signals—such as merchant receipts, invoices, bills, orders, or relevant attachments—to identify candidates before content is downloaded for extraction. Matching is intentionally conservative, but it is not perfect.

New and backfilled candidates are extracted and placed in Needs Review. Confirm the merchant, amount, tax, date, category, and destination before relying on an entry. Duplicate detection can flag a receipt that also arrived by photo or forwarding.

Connection status and recovery

From Settings → Receiving Emails, you can:

start a manual synchronization,
change the destination workspace or filter,
renew Google authorization when Reauthorization required appears, or
disconnect the mailbox.

Temporary Google or network failures are retried. If Google invalidates the mailbox history cursor, Stareceipt performs a bounded catch-up scan instead of continuing from an unsafe cursor.

Disconnect Gmail

Disconnecting stops future synchronization and revokes Stareceipt's Google grant. It does not delete expenses that were already imported, and it does not unlink your Stareceipt login. Delete imported entries separately if you no longer want to retain them.

Deleting your Stareceipt account also revokes and removes connected-mailbox credentials as part of account cleanup.

Use email forwarding instead

To use forwarding:

Open Settings → Receiving Emails and add the address from which you will send receipts.
Verify that address and link it to the correct workspace.
Forward a receipt or invoice to upload@stareceipt.com, or create a provider rule that forwards only receipt-like messages.
Review the extracted result in Needs Review.

Official provider guides:

Forwarding works with common digital receipts such as retailer invoices, SaaS bills, ride-share receipts, food-delivery receipts, and PDF invoice attachments. If your organization blocks automatic forwarding, use manual forwarding or a connected Gmail account where permitted.

Removing a verified receiving email stops future imports from that sender address but does not delete historical entries.

Privacy and security

For connected Gmail, Stareceipt stores the Google refresh credential only on the server in envelope-encrypted form. The app does not receive or store it. Services that retrieve matching messages use short-lived access credentials, and staged message content is temporary. Gmail content is used to provide receipt and invoice extraction—not for advertising, sale of personal data, or general-purpose model training.

For forwarding, Stareceipt processes the messages sent to upload@stareceipt.com and uses the verified sender address to route extracted results. In either flow, avoid importing messages that contain sensitive information unrelated to expense tracking.