Sessions

Link your Vinted accounts and configure shipping preferences.

A session represents a linked Vinted account that the bot uses to interact with Vinted on your behalf. Every action the bot performs (buying items, making offers, favoriting listings, browsing wardrobes, promoting items) requires a valid session. You can link multiple Vinted accounts, each as a separate session, and assign them to different monitors or groups depending on your strategy.

Why Sessions Exist

The bot cannot interact with Vinted without being authenticated as a real Vinted user. A session holds the authentication credentials (refresh token) for one of your Vinted accounts, along with your shipping preferences for that account. You can create multiple sessions and (optionally) organize them into session groups to control which accounts are used for automation.

Creating a Session

  1. 1Run /sessions to open the session management panel. You will see a list of all your existing sessions (if any) with their status indicators.
  2. 2Click + Create to start creating a new session.
  3. 3Enter a name for the session. This is purely for your reference (e.g. "Main FR Account", "German Buyer"). It does not affect any functionality.
  4. 4Enter the domain code for the Vinted marketplace this account belongs to. Use the two-letter code: fr for France, de for Germany, it for Italy, es for Spain, nl for Netherlands, be for Belgium, pl for Poland, pt for Portugal, at for Austria, cz for Czech Republic, sk for Slovakia, hu for Hungary, ro for Romania, lt for Lithuania, lu for Luxembourg, uk for United Kingdom, ie for Ireland.
  5. 5Once created, click Set Token and paste your Vinted refresh token. This token allows the bot to authenticate as your Vinted account.
  6. 6Click Test OAuth to verify the connection. If the token is valid, the bot will display your Vinted username and the session status turns green.
TipPrefer using the Dashboard for day-to-day session management: Open Dashboard

Status Indicators

Sessions use colored indicators to show their current state at a glance:

  • Green circle - The session is active and authenticated. The bot can use it for all operations.
  • Red circle - The session has been created but is not yet authenticated (no token set or token invalid). Set or refresh the token to activate it.
  • Pause icon - The session is archived. It retains all configuration but the bot will not use it for any operations.

Account Types

Each session has a type that controls what the bot is allowed to do with it. This lets you separate buying and selling activities across different accounts:

  • Mixed - The default type. The session can be used for both buying features (purchases, offers, favorites) and selling features (wardrobe browsing, item promotion). Suitable if you use a single Vinted account for everything.
  • Buying - Restricted to buying operations only. The bot will use this session for purchases, offers, and favoriting items, but will never use it for wardrobe browsing or item promotion. The Wardrobe button is disabled for this type.
  • Selling - Restricted to selling operations only. The bot will use this session for wardrobe browsing and item promotion, but will not use it for buying actions (buy, offer, favorite, autocop).

You can cycle through account types by clicking the type button on the session management panel. Each click rotates: Mixed, then Buying, then Selling, then back to Mixed.

Shipping Configuration

Before the bot can buy items for you, you need to configure your shipping preferences. Click Shipping Config on a session to access the shipping settings panel.

Delivery Mode

  • Pickup Point - The item is delivered to a nearby collection point (post office, locker, relay point). You pick it up at your convenience. This is the default mode and is available in most European countries.
  • Home Delivery - The item is delivered directly to your home address. Availability depends on the seller's shipping options and the carriers in your region.

Shipping Strictness

  • Flexible (default) - The bot accepts any carrier the seller offers. This maximizes your chances of a successful purchase because it will not fail due to carrier incompatibility. Recommended for autocop users.
  • Strict - The bot only accepts your preferred carrier. If the seller does not offer that specific carrier, the purchase will fail. Use this only if you have a strong preference for a particular delivery service.

Setting Your Location

Your location is required for finding nearby pickup points and for home delivery. Click Set Location and enter your full address (street, city, country). The bot geocodes your address using a mapping service and displays the result on an interactive map for confirmation. You can confirm if the location is correct or retry with a different address. The address should be as specific as possible. For example, "15 Rue de Rivoli, Paris, France" produces a more accurate result than just "Paris".

Favorite Pickup Point

After setting your location, you can search for nearby pickup points and save one as your favorite. Click Set Favorite Pickup then Search Nearby. The bot queries Vinted's shipping API for available pickup points near your coordinates and displays them on a numbered map with a dropdown selection menu. Select a point from the list and the bot saves it as your default. During autocop purchases, the bot automatically selects this pickup point at checkout, dramatically speeding up the process.

TipSetting a favorite pickup point dramatically speeds up the checkout process during autocop, since the bot does not need to search for nearby points at purchase time. This can make the difference between getting an item and losing it.

Pickup Strategy and Radius

If you use pickup delivery, you can choose how the bot selects a pickup point during checkout:

  • Favorite - Always use your saved favorite pickup point.
  • Favorite → Cheapest fallback - Use favorite when possible, otherwise choose a cheap available point.
  • Closest & Cheapest - Choose a nearby point based on distance and price.

The Pickup Radius controls how far the bot is allowed to search (in km) when it needs to pick a point automatically.

Archive and Delete

  • Archive - Temporarily disables a session without losing any configuration. Archived sessions retain all settings but the bot will not use them. You can unarchive at any time.
  • Delete - Permanently removes a session and all its data. This is irreversible.
WarningDeleting a session is permanent. All pool assignments, shipping configuration, and token data will be lost forever. Archive the session instead if you might need it again later.

Troubleshooting

  • Test OAuth fails - Your refresh token has likely expired. Obtain a fresh token from Vinted and set it again.
  • Session stays red after setting token - Make sure you pasted the complete token without trailing spaces or line breaks.
  • Cannot create more sessions - You have reached your plan's session limit. Check with /my_info.
  • Wardrobe button is disabled - Your session type is set to "Buying". Change it to "Mixed" or "Selling".