Connecting your email

Seller Oracle reads your retailer order emails and turns them into orders. To do that it needs a way into the inbox where those emails land. There are three ways to give it one, and they are equals. Pick whichever fits the inbox you actually use:

Connect Gmail directly.
Connect Outlook directly (including Hotmail, Live, and Microsoft 365).
Forward emails to a Seller Oracle address from any provider.

You can use more than one at once. A common setup is a connected Gmail for your main buying address plus a forwarding address for a second account on a different provider.

All three feed the same processing pipeline, so an order picked up by forwarding is read exactly the same way as one picked up by Gmail.

All email connections are managed under Settings > Email Accounts. See Settings for the rest of the settings pages.

Connecting Gmail

The Gmail connection uses Google OAuth, so Seller Oracle never sees or stores your password.

Go to Settings > Email Accounts and click Connect Gmail Account.
On the Seller Oracle connect screen, set the Import emails from date (see How far back the first import reaches), then click Connect Gmail Account again.
Sign in with the Gmail account that receives your retailer emails.
Grant the permissions Google asks for. Leave every box ticked. Seller Oracle needs the gmail.modify scope so it can read your emails and apply SO/ labels. It does not send, delete, or mark emails as read.
You land back on Seller Oracle and the account appears in your Gmail Accounts list, marked Connected.

If you untick a permission, the connection is rejected and you are asked to reconnect with all boxes left ticked. Seller Oracle cannot work without the full gmail.modify scope.

The "unverified app" warning during beta

While Seller Oracle is in beta, Google has not yet finished verifying the app, so the consent screen may show a warning that the app is unverified. This is expected and does not mean anything is wrong with your connection. Click Advanced, then Go to Seller Oracle, and carry on. The connection is still OAuth, and your tokens are encrypted at rest.

Connecting Outlook

Outlook connects through Microsoft Graph, again using OAuth rather than your password. It covers Outlook, Hotmail, Live, and Microsoft 365 accounts.

Go to Settings > Email Accounts and click Connect Outlook Account.
Set the Import emails from date, then click Connect Outlook Account again.
Sign in with your Microsoft account and accept the permissions.
The account appears in your Outlook Accounts list, marked Connected.

The permission Seller Oracle requests is Mail.ReadWrite, so it can read your emails and apply categories to processed ones. It also requests offline access so it can stay connected without you having to sign in again every hour. A brand-new connection has to grant that offline access. If it doesn't come through, you are asked to reconnect and accept all permissions.

Forwarding emails

If you would rather not connect a mailbox directly, or your orders arrive on a provider Seller Oracle doesn't connect to, forward them instead. This works with Gmail, Outlook, Yahoo, or anything else.

Go to Settings > Email Accounts and find the Email Forwarding section.
Click Create Inbound Address. Seller Oracle generates a unique address ending in @inbound.selleroracle.com, for example a1b2c3d4e5f6a7b8@inbound.selleroracle.com.
Click Copy to copy the address.
In your email provider, set up a forwarding rule that sends your retailer order emails to that address.

The address is unique to you, so keep it private. Anything forwarded to it is processed exactly like a directly connected mailbox.

You can rename a forwarding address at any time by clicking its label and typing a new one.

Managing your connections

Get Emails now

Seller Oracle polls your connected Gmail and Outlook accounts on its own schedule and picks up new emails within a few minutes. If you have just placed an order and want it pulled in straight away, click Get Emails at the top of the Email Accounts section. It triggers an immediate fetch across every connected account that is polling.

Each connected account shows its Polling state and how long ago it was last polled, so you can see at a glance whether it is keeping up.

Reconnect

A connection can lapse, usually because its access expired or a permission is missing. When that happens the account is flagged with Authorization expired or Permission missing in your Email Accounts list, and a banner appears at the top of the page with a Reconnect button next to the affected account.

Reconnecting runs the same OAuth flow as the first connection. Sign back in and leave all permission boxes ticked. Polling resumes once the connection is healthy again.

Disconnect

To stop using a connected Gmail or Outlook account, click Disconnect on its row and confirm. The connection stops syncing and its stored tokens are removed. For Gmail, Seller Oracle also revokes its access at Google. You can reconnect the same account later whenever you want.

Managing forwarding addresses

Each forwarding address has its own controls.

Regenerate replaces the address with a brand-new one. The old address stops working immediately, so update your forwarding rule straight away. This is a destructive action, so you are asked to type REGENERATE to confirm it.
Pause stops an address processing forwarded emails. Anything sent to a paused address bounces. The address still exists and can be brought back later.
Reactivate brings a paused address back so it processes forwarded emails again.
Delete permanently retires an address. It stops accepting emails for good and cannot be reactivated. Your email log history for that address is kept. Because this can't be undone, you are asked to type DELETE to confirm.

How many addresses you can have

By default you can have up to three active forwarding addresses at once. Paused addresses don't count towards that limit, only active ones do. Once you hit the cap, the create button is replaced with a note showing how many you are using (for example "Maximum addresses reached (3/3)"). If you need more, contact support and the limit can be raised on your account.

How far back the first import reaches

When you connect a mailbox you choose an Import emails from date. Only emails after that date are imported, and the default is today, so by default Seller Oracle starts fresh from the moment you connect and won't reach back into old orders.

To bring in existing orders, set the date back to where you want the history to start.

How far back you can go is capped by your plan and trial. If you pick a date earlier than your plan allows, Seller Oracle pulls the date forward to the earliest date you're entitled to rather than rejecting the connection. A trial reaches back a set window; paid plans reach back further. See Billing and trial for the limits that apply to your account.

Labelling in Gmail and categorising in Outlook

As it processes emails, Seller Oracle can tidy your mailbox by tagging the ones it has handled: SO/ labels in Gmail, SO/ categories in Outlook. Both are on by default and both have a toggle.

These toggles live under Display in Settings, not in the Email Accounts section. Turn either one off if you would rather Seller Oracle left your mailbox untouched while it works. See Settings for the Display options.

Last reviewed: June 02, 2026