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. ☕

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.

1. Open a new browser tab and go to developer.ebay.com.
2. Click Register (or "Join now"). It's completely free.
3. 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.
4. 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.

1. Still on developer.ebay.com, look for a menu called My Account, then Application Keysets (it might just say "Keys").
2. 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.)
3. 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.

1. 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").
2. 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.
3. eBay then shows you a RuName. It looks like YourName-AppName-PRD-a1b2c3-d4e5f6. Copy it — that's your 4th and final code.

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 🔗

1. Click the Connect to eBay button in the top-right corner of ESS.
2. A little box appears. Click Open eBay Sign-in. eBay opens in a new tab.
3. 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.)
4. 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.

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" — usually nothing changed: the tool double-checks the new listing with eBay before ending your old one, so a failed item simply stays live, untouched. In the rare case a listing did end without the new copy posting, go to My eBay → Selling → Unsold, find the item, and hit eBay's own Relist — it'll be back in a minute. Either way, 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. 💬