Add and configure a Vinted account
Connect your Vinted accounts, manage their state, payment, shipping and groups — everything needed to make autocop operational.
Introduction
Autocop only triggers a purchase on an account that is active, verified, with a card and address. This page covers the full lifecycle of a Vinted account in Kops: add, configure, statuses, shipping, groups, troubleshooting.
Before connecting an account, read the safe Vinted account creation guide. Connecting a poorly prepared account can get it banned in under 24 hours.
1. The Accounts page
Available at /accounts from the side menu.
[Image of the full /accounts page: header, status filters, search, accounts table]
The page has 4 zones:
| Zone | Role |
|---|---|
| Status filters | Tabs Active / All / Quarantined / Inactive with live counters |
| Search + groups | Filter by username or by group (folder) |
+ Add account button | Top right — opens the add modal |
| Table / list | One row per account, status + readiness badges |
If your plan limit is reached, the button is replaced by
Upgrade planand shows the remaining quota.
2. Adding an account
Click + Add account. A modal opens with two tabs: Login (default) and Tokens.
[Image of the add account modal showing the Login / Tokens tabs]
2.1 Login method (recommended)
The simplest and most robust path: Kops handles Vinted authentication itself, including 2FA.
- Email — the Vinted account's email (not your Kops email)
- Password — the Vinted account password
- Click
Log in
Kops validates the credentials against Vinted, retrieves the ID, username, country and avatar, then adds the account.
[Image of the Login form: email + password fields + Log in button]
Two-factor authentication (2FA)
If 2FA is enabled on the Vinted account, a verification step appears:
- A 4-digit code is sent by email or SMS (Vinted picks based on the account's setup)
- The screen displays the masked address or number where the code was sent
- Type the code — verification fires automatically at the 4th digit
[Image of the 2FA step with the OTP input and "Code sent to •••@•••.com"]
Possible errors at login
| HTTP code | Message | Cause | Action |
|---|---|---|---|
| 401 / 422 | Invalid email or password | Wrong credentials | Retry |
| 429 | Too many attempts | Vinted rate limit | Wait 5 to 10 minutes |
| 500 | Vinted temporarily unavailable | Vinted-side incident | Retry later |
| — (2FA) | Invalid code | Wrong code | Check your inbox or SMS |
| — (2FA) | 2FA session expired | Took too long | Restart the login |
2.2 Tokens method
Use this method when login fails (captcha-protected account, geoblock…) or if you'd rather not share your password.
- Access Token — JWT string starting with
eyJ… - Refresh Token — optional but strongly recommended. Without it, Kops cannot regenerate the session and the account will go inactive as soon as the access token expires (about 10 minutes).
- Click
Validate and add
[Image of the Tokens form with both Access Token / Refresh Token fields]
Get your Vinted tokens
Install the Chrome extension Vinted Token Finder:
- Log in on
vinted.fr(or.com,.de, etc.) - Click the extension icon
- Copy both tokens with one click
warning Tokens are bound to the session and the device. Copying them from one browser then logging back into Vinted from another invalidates the copied tokens. Grab them right before pasting into Kops.
[Image of the Vinted Token Finder extension open with both tokens visible]
3. Account statuses
The table shows the current status of each account.
| Status | Dot | Meaning | Recovery |
|---|---|---|---|
| Active | active green | Authenticated, ready to buy | — |
| Quarantined | quarantined orange | Temporarily blocked by a Vinted protection signal | check Automatic |
| Inactive | inactive grey | Dead session, banned account or manually disabled | cross Action required |
3.1 Quarantine — details
Kops automatically quarantines an account when Vinted returns a protection signal (rate limit, captcha, behavior flagged as suspicious). The duration depends on the signal and ranges from 30 minutes to 24 hours.
The account becomes active again automatically at the end of the delay. You can also force release via the Release button in the account detail — use carefully: quarantine is exactly what protects you from a ban.
[Image of the quarantine banner in the detail modal showing "Releases in 47m" timer and Release button]
3.2 Inactive — precise reasons
The Inactive status always hides a specific reason, readable in the account detail:
| Reason | Meaning | Action |
|---|---|---|
| Session expired | The refresh token is no longer valid | Reconnect (login or new tokens) |
| Repeated authentication failure | Vinted rejects signed requests | Reconnect |
| Account banned | Vinted suspended the account | cross None — the account is permanently lost |
| Subscription expired | Your Kops plan is not active | Reactivate the plan |
| Manually disabled | You paused it yourself | Reconnect if needed |
| Unknown | Reason not reported | Reconnect |
[Image of the red Inactive banner with reason "Session expired" and Reconnect button]
The
Reconnectbutton opens the same modal as adding, but inreactivatemode: Kops verifies that the new credentials match the same Vinted account as the one being reconnected (otherwise an HTTP 409 "Identity mismatch" error).
4. The account detail
Click a table row to open the detail modal.
[Image of the account detail modal showing all sections]
It is composed of 5 sections:
4.1 Identity
- Vinted avatar, username prefixed with the country flag
- Vinted ID (click to copy)
- Email (click to copy) +
Email verifiedcheck/⚪ indicator Phone verifiedcheck/⚪ indicator- Country (FR, DE, IT…)
- Last update time (resync)
4.2 Credit card
| State | Display | Action |
|---|---|---|
| No card | "No card" tile | + Add |
| Card present | Brand + •••• 4242 + MM/YY + holder name | Change |
[Image of the credit card tile with a saved card and the Change button]
Without a saved card, autocop will never use this account. Having a valid card isn't enough: for higher speed, prefer a card without 3D Secure authentication (see Buy faster).
4.3 Shipping address
| State | Display | Action |
|---|---|---|
| No address | "No address" tile | + Add |
| Address present | Name + line 1, city, postal code | Change |
The address acts both as billing address and as the geographic reference point to compute the nearest pickup point.
4.4 Shipping preferences
Three modes available, switchable at any time via the Manage button.
[Image of the Shipping preferences modal opened on Pickup point mode]
Contact phone (optional, shared across all three modes) — used at purchase time when Vinted has no phone on file for the account. If left empty, a fallback number is used.
The package is delivered to a Vinted pickup point (Mondial Relay, Relais Colis, InPost…). Two sub-modes coexist: Nearest (default) and Priority list.
Nearest (default)
Zero configuration. At purchase time, Kops compares the pickup points Vinted offers for that specific item (the list varies per seller, carrier and item) with your address, and automatically picks the closest one.
This is the mode that maximizes success rate: if a single relay is offered, it gets picked.
[Image of the "Nearest active" sub-mode with the centered info message]
Priority list
You rank your favorite relays. On every purchase, Kops walks your list top-down and picks the first relay Vinted offers for that item.
This is the mode that maximizes control — at the cost of a slightly lower success rate when Vinted doesn't offer any of your favorite relays.
How the list fills up ("discovery")
The list isn't built by hand: you can't add an arbitrary relay to it. Instead:
- You start
Priority listmode with an empty list ("No points discovered. Points will appear after the first purchase.") - As Kops buys in
Nearestmode (or even inPriority listwhen a default relay was used), every relay actually used is memorized and appears in your point library - Step by step you build your personal catalog of relays — those that are actually available in your area, already vetted by successful purchases
- Once a few points are discovered, you can drag and drop them to set your priority order
[Image of the "Priority list" sub-mode with several ranked points and the drag handle]
Excluding a carrier on a specific relay
Each discovered relay can be served by several carriers (e.g. Mondial Relay and Relais Colis on the same physical point). If one of them is problematic on a specific relay (hours, unfriendly owner, reliability), you can exclude it on that relay only without affecting the others.
- Click the carrier pill on the relay card → tooltip "Exclude this carrier for this point"
- The excluded carrier is then ignored only on that relay; it stays usable on the other relays of your list
- Click again to re-enable it
Exclusion is finer than removing a relay: it lets you say "I like this point, but not with this carrier."
What autocop sees at purchase time
For a given item, autocop applies this selection logic:
- Vinted returns the list of relays actually offered for the item (varies item by item)
- Kops walks your priority list top-down
- The first relay that is both (a) in the Vinted list and (b) not excluded for the carrier in use → that's the one selected
- If none of your relays match, the purchase fails on shipping (the trade-off of
Priority listmode)
Reset discovery
Button at the bottom-left of the modal. Wipes the entire discovered relay list.
- Your mode (priority or nearest) is kept
- Relays will be rediscovered automatically on the next purchases
- Useful after moving, or if many old relays are no longer relevant
[Image of the reset discovery confirmation dialog]
Preferences shared between accounts
If multiple accounts use the same address, they automatically share shipping preferences (mode, priority list, phone). A blue banner warns "Shared with X other account(s)" — any change applies to all of them.
[Image of the blue "Shared with 3 other account(s)" banner at the top of the modal]
4.5 Team members
List of users in your organization who have access to this account. Shows: email/username, role (owner, admin, member, viewer), assignment date. Empty = nobody else has access.
[Image of the Team members section with two assignments]
5. Account actions
The detail modal footer exposes the main actions.
| Button | Effect |
|---|---|
Refresh | Re-syncs the account with Vinted (avatar, verifications, card, address) |
Quarantine | Manually pauses the account (use if you suspect risk) |
Release | Visible only when the account is quarantined |
Reconnect | Visible when the account is Inactive (except banned account) |
Delete delete | Removes the account from Kops (does not touch the Vinted account) |
Delete≠ ban. Deletion only erases the data Kops stores (tokens, card, address, stats). The Vinted account itself stays intact.
5.1 Bulk actions
Select multiple accounts via the table checkboxes to enable the bulk action menu:
- Refresh — resync all selected accounts
- Quarantine — group pause
- Release — group release
- Delete — group deletion (with confirmation)
[Image of the bulk actions menu activated after selecting 3 accounts]
6. Account groups (folders)
Groups let you organize accounts by role, by team member, or by strategy. A group = a colored label.
6.1 Create a group
From the Groups menu on the Accounts page:
- Click
+ New group - Type a name (e.g. Sneakers, Vintage, Sarah's account)
- Pick a color from the palette
- Confirm
[Image of the manage groups modal with the color palette]
6.2 Assign an account
From the account detail or via the table row's ⋮ context menu:
- Click
Groups - Tick the wanted groups (an account can belong to multiple groups)
- Confirm
6.3 Filter by group
The colored pills above the table filter the list. Click to enable a group; click again to disable. Combinable with search and status filters.
[Image of the group pills active above the table with one filter selected]
7. Readiness badges
On each table row, compact badges flag the account's readiness:
| Badge | Meaning |
|---|---|
| ✉️ green | Email verified |
| 📞 green | Phone verified |
| 💳 green | Card saved |
| 📍 green | Address saved |
Greyed badge with + | Item missing — click = direct add |
An account is fully ready only when email, card and address are all set.
[Image of a row with all green badges versus a row with greyed badges]
8. Plan limits
The number of connectable accounts depends on your organization's plan. When the limit is reached, the + Add account button becomes Upgrade plan and shows the remaining quota.
9. Troubleshooting
Most likely cause: you provided an access token without a refresh token. The access token expires in about 10 minutes. Always provide the refresh token so Kops can regenerate the session automatically.
You're trying to reconnect account A with credentials or tokens from account B. Kops checks the returned Vinted ID and refuses, to prevent overwriting your data.
→ Reconnect with the right account's credentials, or delete the old one and create a new one.
Vinted has temporarily blocked login attempts for this IP or account. Wait 5 to 10 minutes before retrying. If the problem persists, switch to the Tokens method.
Common causes:
- Datacenter IP or VPN detected by Vinted
- Inconsistent browser fingerprint
- Multiple accounts linked by card, address or device
→ Read the Safe Vinted account creation guide to clean up the environment.
Check in this order:
- The account is Active (not quarantined or inactive)
- A card is saved (green 💳 badge)
- An address is saved (green 📍 badge)
- The email is verified on Vinted
- The filter matching the item is linked to a group containing this account (if you use groups)
The 2FA code wasn't entered fast enough (Vinted allows about 5 minutes). Restart the login: a new code will be sent.
Possible causes:
- List too short: with only one or two relays, the odds Vinted offers at least one of them on every item are low
- Too many carrier exclusions: each exclusion shrinks coverage
- Items from another country: a French relay will never come up for a German seller
→ Either grow the list (let Kops discover more relays in Nearest mode for a few days), or switch to Nearest for international filters.
Going further
- Sequential vs parallel mode — how Kops dispatches purchases across your accounts
- Buy faster — 3DS card optimizations, latency, session pre-warming
- Safe Vinted account creation — avoid bans from day one