What is this? 🃏 ESS keeps your oldest eBay listings fresh. It finds your 5 oldest active listings and can re-list them at a slightly lower price, so eBay's search treats them as brand new again and shows them to more buyers.
This guide assumes you're starting from scratch — no eBay developer account, no "API keys", nothing, and no idea what any of those words mean. That's totally fine. Just do each step in order and don't skip ahead. It takes about 15 minutes the first time, and you never have to do the setup part again.
What you'll need handy: your eBay Australia login (email + password), and about 15 quiet minutes. ☕
🇦🇺 Read this first — the #1 mistake people make. ESS only works with eBay Australia (the ebay.com.au website). eBay's setup pages and sign-in screens often default to the American site without telling you. If you accidentally use a US eBay account anywhere below, ESS ends up looking at the wrong shop and none of your listings will appear. So at every single step: check the web address starts with ebay.com.au, and that you're signed into your own Australian eBay account — not a friend's, not a US one.
Step 1 — Make a free "eBay Developer" account 👩💻
Plain English: this is a separate free account that lets a tool like ESS talk to eBay on your behalf. You only set it up once.
- Open a new browser tab and go to
developer.ebay.com.
- Click Register (or "Join now"). It's completely free.
- When it asks you to sign in, use your eBay Australia account — the same email and password you use to sell your cards. Double-check it's your AU account.
- Tick the box to accept the agreement and finish. Done — you now have a developer account.
Step 2 — Get your 3 "keys" 🔑
Plain English: "keys" are just long codes — like a username and password specifically for the app. You'll copy 3 of them.
- Still on
developer.ebay.com, look for a menu called My Account, then Application Keysets (it might just say "Keys").
- You'll see two columns: Sandbox and Production. Always use Production. (Sandbox is a pretend, practice version of eBay — it won't touch your real store, so ignore it.)
- Under Production, click the button to create/generate the keys. Three codes appear. Copy each one somewhere safe (like a Notes app). They're labelled:
- App ID (Client ID)
- Dev ID
- Cert ID (Client Secret)
Step 3 — Get your "RuName" 🔁
Plain English: one more code that tells eBay it's OK for ESS to sign you in. Sounds scary, isn't.
- On that same Production keys page, look for User Tokens, then a link like Get a Token from eBay via Your Application (sometimes called "Sign-in Settings" or "OAuth").
- Choose to add a new sign-in setting. It'll ask for a title and two web addresses:
- Accept Redirect URL:
https://esstool.duckdns.org/auth/ebay/callback — copy-paste this exactly.
- Privacy Policy URL: any real web address (even
https://www.google.com) — it doesn't matter.
- eBay then shows you a RuName. It looks like
YourName-AppName-PRD-a1b2c3-d4e5f6. Copy it — that's your 4th and final code.
📨 Now hand those 4 codes to the admin — and pick your password. Send your App ID, Dev ID, Cert ID and RuName to whoever runs ESS for you (the person who shared this app), along with a password of your own choosing that you'll use to log in. You do not type any of this into ESS yourself — the admin sets it all up behind the scenes. Treat the codes like passwords: send them privately (a direct message), not in a public group. Once the admin confirms you're added, you're ready for the steps below. 🎉
Step 4 — Log in to ESS 🚪
Type in the password you chose in Step 3 (once the admin confirms your store is set up) and click Login. Your browser remembers it, so you normally only ever do this once on this device.
Step 5 — Connect your eBay account 🔗
- Click the Connect to eBay button in the top-right corner of ESS.
- A little box appears. Click Open eBay Sign-in. eBay opens in a new tab.
- Stop and check two things in that new tab: the address starts with
ebay.com.au, and you're logged into your own Australian eBay account. Then click to agree/allow the permissions. (If it shows the wrong account, log out and back in as you first.)
- eBay redirects you back to ESS automatically. The new tab says "Connected!" and ESS picks it up within a few seconds.
The badge at the top turns green and says Connected ✅, and your listings load. That's it — you're fully set up, and this connection lasts about 18 months. If it ever says "Not Connected" again, just repeat Step 5 (the button will read Reconnect).
If eBay doesn't redirect you back (e.g. the redirect URL isn't set up yet), click "Not redirecting?" in the connect box and paste the code from the URL manually — same as before.
⚠️
Before you touch "SELL SIMILAR" — please read this. These are the only ways to actually cost yourself money.
- Always check the price in the little box first. Whatever number is in that box becomes the real selling price of the new listing. ESS fills in a sensible price for you (a few cents lower), but if you type your own and slip — say
4.50 instead of 45.00, or an extra key turns $40 into $4 — a buyer really can grab your card for that price. Read the price before every run.
- "SELL SIMILAR ALL" can't be undone. It genuinely ends your 5 oldest listings and creates new ones. There's a confirmation pop-up — read it, don't just click OK out of habit. Only run it when you actually mean to re-list.
- You can't accidentally sell the wrong shop's items — but only if you connected the right account in Step 5. This is exactly why the "check it's YOUR AU account" step matters.
Good news: everything else is safe. The
× button just hides a card and undoes itself after 30 days, and if a re-list fails, nothing is lost (see troubleshooting below).
Using it day-to-day 🛠️
- Search Again — reloads your 5 oldest active listings. Safe to click anytime.
- The price box + the → arrow — shows the new, slightly-lower price each card will get. You can type your own, but see the warning above and double-check it.
- SELL SIMILAR ALL — the big button. Ends those 5 listings and re-lists them fresh with tweaked titles and the lower price. When it finishes, click Search Again to load the next 5.
- × on a card — hides that one card from the rotation for 30 days (handy if there's a listing you never want auto-relisted). It comes back on its own; nothing is deleted.
- 🏆 Trophies — fun seasonal achievements for your store. Purely for bragging rights.
- Relist History — further down the page, it lists everything you've re-listed and whether it's SOLD yet.
Something not working? 🩹
- No listings show up, or they look like someone else's — you're almost certainly connected to the US site or the wrong account. Click Reconnect and carefully redo Step 5, making 100% sure it's
ebay.com.au and your own account.
- "Wrong password" when logging in — that's asking for the ESS password you chose in Step 3, not your eBay password. If it won't work, check with the admin that your store's been added with that exact password.
- The automatic redirect didn't work / the code won't submit — make sure the Accepted Redirect URL (Step 3) is set correctly. If it's not set up yet, use the manual paste fallback (click "Not redirecting?"). Either way, codes only work once and expire within a few minutes — click Open eBay Sign-in again to get a fresh one.
- One of the 5 said "failed" and now a listing seems to have vanished — don't panic, nothing is lost. It was ended but the new copy didn't post. Go to your normal eBay account, open My eBay → Selling → Unsold, find the item, and hit eBay's own Relist — it'll be back in a minute. Then tell the admin which item failed so they can check why.
- The badge says "Not Connected" after a long time — totally normal after ~18 months. Just click Reconnect and do Step 5 again.
Still stuck or unsure? Don't guess — message whoever set this up for you and they'll sort it out. Better to ask than to click and hope. 💬