Connecting your Gmail mailbox

Your sale confirmations already land in your mailbox. The Gmail connection is there to read them, pull out the item, the price and the date, then offer the sale to you inside your inventory. You confirm, StockFeel writes. Never the other way round.

What the connection allows, and what it does not

Google's consent screen announces a read and modify permission on Gmail. The modify permission serves exactly one purpose: putting a StockFeel-Vu label on emails that have been analysed, so the next pass does not read them again and never offers you the same sale twice. Order confirmations get StockFeel-Vu-Achat, because sale detection and purchase detection are two distinct readings of the same message.

• No email is ever sent from your account.
• No email is deleted, archived or moved.
• Not all of your email is read. The search rules out promotions, social notifications, security alerts, password resets, newsletters, food delivery, transport and subscriptions from the start. It then prioritises subjects carrying a word about an order, a sale, a shipment, a parcel, tracking, an invoice or a payment.
• Attachments are never downloaded.
• The body of an email is not kept. The sender, the subject and the useful part of the text are passed, for the duration of the analysis, to Google's paid Gemini API, which trains no model on them. What StockFeel keeps is the message id for 120 days at most, so it knows it has been handled, and the sale or purchase drawn from it. The detail is in the privacy policy.
• You can cut the access at any time, from StockFeel or from the third-party apps page of your Google account.

Connecting the mailbox

1. 1

   Open Configuration, Gmail detection section

   In StockFeel: Settings, then Configuration. The Gmail detection section is the second one on the page.

2. 2

   Click Connect Gmail

   You land on Google's consent screen, hosted by Google. StockFeel never sees your password.

3. 3

   Pick the account that receives your confirmations

   Not your main address out of habit: the one you gave to eBay, StockX or Vinted. If it is not a Gmail address, go through Forwarding mail from another mailbox instead.

4. 4

   Accept the authorisation

   Google asks again on every connection, even if you have already authorised StockFeel. That is deliberate: it is the only way to obtain the refresh token without which detection would stop after an hour.

5. 5

   Run a first synchronisation

   Back in StockFeel, the card shows CONNECTED and the linked address. Click Synchronise now: the first pass picks up the recent backlog, the following ones only handle what has arrived since.

One mailbox or two

By default a single mailbox serves both detections: the same pass looks for sales and for orders in it. That is the right setting for the vast majority of accounts.

If your purchases arrive somewhere other than your sales, untick One single mailbox for sales and purchases: the section then shows two slots, Sales mailbox and Purchases mailbox, to be connected separately. Each keeps its own label, so an order confirmation that the sale reading discarded can still be analysed as a purchase.

What happens next, without you

A detection pass runs every five minutes and takes accounts in turn, three at a time: your mailbox is therefore not queried exactly every five minutes, but several times an hour. The Synchronise now button is there so you do not have to wait.

What a pass finds does not enter your stock. It leaves a suggestion: the item it believes it recognises, the price read in the email, the date. You confirm the match, and it is that gesture which decrements the quantity and creates the sale line. A tracking number spotted in a shipping email follows the same path.

When it does not work

"Address not retrieved, reconnect the account." The authorisation went through but Google did not return the address. Disconnect then reconnect: the second pass asks for it again.

"No matching email found in Gmail." The connected mailbox is not the one receiving the confirmations, or they are older than the search window. Check the address shown on the card, and search StockFeel-Vu by hand in Gmail: if the label exists and is empty, no message has been retained yet.

"X emails analysed, no confirmation detected." The emails were read, but none looked like a sale or order confirmation. That is the normal case on a mailbox with no recent activity.

"AI quota reached." The analysis goes through a model, and its quota is shared. Try again in a few minutes, the pass resumes where it stopped.

A synchronisation announced as partial. Every pass has a time budget. What it did not finish is picked up by the next one, and running it by hand speeds the catch-up up without duplicating anything.

Disconnecting

The Disconnect button removes the token from StockFeel. Your items, your sales and your history stay intact: only detection stops. Labels already placed stay in Gmail, and you can delete them from Gmail's label settings.

To cut the access from the other end, open the third-party apps page of your Google account and remove StockFeel. The effect is the same, and immediate.