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, click Connect Gmail Account again. If the screen asks for an Import emails from date, set it first (see How far back the first import reaches).
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 under Gmail, 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.

Seller Oracle reads all your mail except Spam, Trash, Sent, Drafts and the Promotions, Social and Forums tabs.

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.
Click Connect Outlook Account again. If the screen asks for an Import emails from date, set it first.
Sign in with your Microsoft account and accept the permissions.
The account appears under Outlook, 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.

Seller Oracle reads every folder in your Outlook mailbox except Junk Email, Deleted Items, Sent Items, Drafts and Outbox. It can't read Microsoft's separate online archive mailbox.

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 Forwarding addresses 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. It also appears in the menu that opens when you click your workspace name at the top of the sidebar, so you can copy it from any page later.
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 checks your connected Gmail and Outlook accounts every couple of minutes on its own. If you have just placed an order and want it pulled in straight away, click Get Emails at the top of the Email accounts page, or Get emails in the workspace menu. Either one checks every connected account that is polling. You can use it once every 10 minutes for your whole workspace, whichever button you or a teammate presses. Until then the buttons can't be pressed, and a note says when you can check again.

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, with a line saying what went wrong and a Reconnect button next to it. A banner at the top of the Dashboard shows the same Reconnect button.

Owners and admins also find a Reconnect button next to the account in the workspace menu.

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. You can reconnect the same account later whenever you want.

For Gmail, Seller Oracle also asks Google to remove its access. If Google doesn't confirm it, a message tells you, with a link to your Google account permissions where you can remove it yourself.

Microsoft doesn't let an app remove its own access, so after you disconnect Outlook, Seller Oracle stays listed in your Microsoft account until you remove it there: in your Microsoft account app permissions for a personal account, or in My Apps for a work or school account. Seller Oracle can't read the mailbox in the meantime, because its tokens are removed.

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.
Show in workspace menu puts the address in the workspace menu, so owners and admins can copy it from any page. Every active address shows in the workspace menu unless you switch it off under the address.

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.

Owners and admins can click the workspace name at the top of the sidebar to see how everything is connected. The menu shows your plan's order count for the month (owners on the Free and Starter plans), each connected Gmail and Outlook account with when it last synced, and your Amazon connection. Your active forwarding addresses are listed too, each with a Copy button. To leave one out, switch off Show in workspace menu under it in Settings > Email accounts.

A red dot on the workspace name means an email account needs attention, for example because its sign-in has expired. Open the menu and click Reconnect next to it.

Click Get emails in the menu to check your inboxes straight away. A yellow circle spins next to each inbox until it has been checked, then it shows as synced again.

How far back the first import reaches

When you connect a mailbox, Seller Oracle brings in the last 2 weeks of order emails, so orders still on their way show up straight away. Older orders aren't brought in, so your Action Centre doesn't fill up with work you finished long ago.

If you'd like older orders brought in, raise a ticket from Help & support and we'll talk it through with you first. Older orders arrive without the delivery and invoice emails that would mark them done, so they show up as work to clear.

This applies to every new Gmail or Outlook connection, on every plan. Reconnecting an existing mailbox keeps its saved import window.

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.

The switches sit on the Email accounts page in Settings, under Gmail and under Outlook. Each person sets their own, and it applies to the inboxes they connected. Turn either one off if you would rather Seller Oracle left your mailbox untouched while it works. See Settings.

Last reviewed: 19 October 2026

Connecting your email