How to connect OLX with easySales: a complete integration guide
Connect your OLX account to easySales in Romania, Bulgaria, Poland or Portugal. Authorize easySales from the connect form, complete your contact and location details, map your categories, then publish ads from your catalog and keep their stock and prices in sync. Note that OLX authorizations expire every 30 days and need renewing.
What you can do with OLX and easySales
easySales publishes your products to OLX as ads and then keeps them current: prices and stock follow your catalog, ads come down when a product sells out, and go back up when it is restocked. You maintain one catalog for every channel you sell on instead of editing each OLX ad by hand.
That matters most at volume. Listing fifty products on OLX by hand is an afternoon; keeping fifty ads accurate as stock moves is a permanent job, and it is the part easySales takes over.
Four OLX marketplaces are supported, each connected separately and each with its own currency:
| Marketplace | Country | Currency |
|---|---|---|
| OLX | Romania | RON |
| OLX BG | Bulgaria | EUR |
| OLX PL | Poland | PLN |
| OLX PT | Portugal | EUR |
They are independent connections. Selling on both OLX.ro and OLX.bg means two connections, each with its own contact details, location and category mapping.
How the OLX connector works
easySales connects to OLX over OLX's own OAuth authorization — you approve easySales from inside your OLX account rather than copying an API key around, so there is no API key to store or rotate.
The authorization lasts 30 days, and renewing it is a routine you should plan for. This is the single most important operational fact about the OLX integration: unlike most channels, an OLX connection does not stay live indefinitely. easySales checks every connection daily and emails you once yours passes 28 days, giving you a couple of days' notice before ads stop syncing.
The integration runs in one direction: your catalog goes out to OLX as ads, and OLX does not send orders back. This is an OLX boundary rather than an easySales one — OLX does not make its orders available to integrations, so there is no OLX order screen in easySales, no invoice raised against an OLX sale and no AWB generated for one. You keep serving OLX buyers in your OLX account, exactly as you do today.
Before you start
An OLX account you can sign in to
You authorize easySales from inside OLX, so you need the credentials for the account that will carry the ads.
Your contact details and location decided
Contact name, phone, city and district appear on every ad. Pick the ones you want buyers to see before you connect.
Products in your easySales catalog
Ads are generated from products you already hold in easySales. Nothing publishes from an empty catalog.
An idea of your free ad allowance
OLX caps free ads per account. Knowing your ceiling tells you how much of your catalog can go live before you need to buy capacity.
Step 1 — Open the connect form and authorize easySales
In easySales go to Integrations → Marketplaces, find the OLX marketplace for your country and click Connect.
The form opens with an Authenticate with OLX button. Clicking it sends you to OLX's own sign-in and permission screen. Approve easySales there and you are returned to the connect form, now linked to that OLX account.
If you ever need to point the connection at a different OLX account, or the authorization is revoked on OLX's side, the same button reappears as Reauthenticate with OLX. Use it rather than deleting and rebuilding the connection — re-authenticating keeps your category mapping and your linked ads.
Step 2 — Complete the connection settings
Authorizing is only half of it. The form below carries the settings every ad inherits, and OLX will not accept ads until the required ones are filled in.
Identity and location
- Connection Name — how the connection is labelled inside easySales. It is never shown to buyers, so name it for yourself: OLX Romania, OLX BG warehouse 2.
- Contact name and Contact phone — what OLX shows on the ad. This is the number buyers will call.
- City and, optionally, District — where the ad is posted. Pick the city first; the district list is filtered by it. District can be left empty.
Pricing
- Price Addition — a percentage added on top of your product price for this channel only. At 10%, a product priced 10 goes out as 11. It applies to the price easySales sends; your catalog is untouched.
- Vat Payer — set this to Yes only if the account you registered on OLX is VAT-registered. It changes how prices are calculated, so getting it wrong shifts every ad.
Ad defaults
- Default product state — New or Used, applied to ads that do not specify their own.
- Auto Refresh — republishes ads automatically when they expire. OLX ads do not run forever, and without this they lapse to the outdated status and quietly stop being seen.
- Courier delivery — Yes if you ship with a courier, No if buyers collect in person.
- Implicit package type, Default shipping tax and Shipping Information — the delivery defaults carried onto your ads. Shipping Information is appended to the end of every ad description.
- New order custom status — optional, and only relevant if you use custom order statuses elsewhere in easySales.
Stock behaviour — two toggles that decide what happens as stock moves:
- Deactivate offers when products run out of stock — takes the ad down when the product hits zero, instead of leaving it live for buyers who cannot be served.
- Automatically enable offers when products have stock — puts it back up when the product is restocked.
Turning both on is what makes the integration self-maintaining. Leave them off and you are back to managing availability by hand.
Step 3 — Map your categories
Ads will not publish until your categories are mapped. easySales needs to know which OLX category each of your own categories belongs in, because OLX decides what an ad may contain from its category.
Some OLX categories also require a subcategory before an ad will run — Phones needs the make, for example. If ads are rejected immediately after a first publish, an unmapped subcategory is the usual reason.
Step 4 — Publish your first ads
With the connection authorized and categories mapped, go to Products, select what you want listed and use Add Offer to generate the ads.
Start with a handful rather than the whole catalog. The first batch tells you whether your category mapping and your ad defaults are right, and fixing ten ads is a great deal easier than fixing a thousand.
One OLX rule catches people out: OLX accepts ad titles of at most 70 characters, which is shorter than a lot of product names. easySales states this on the connection screen itself. Longer titles are cut or rejected, so it is worth checking your longest product names before a large publish.
Ad statuses you will see
After publishing, each ad carries a status in easySales that mirrors what OLX reports:
| Status | What it means |
|---|---|
| new | Created in easySales, not yet live on OLX |
| active | Live and visible to buyers |
| limited | You have used up your free ad allowance |
| moderated | Held by an OLX moderator for review |
| unconfirmed | Waiting on confirmation |
| outdated | Expired — OLX ads do not run forever |
| unpaid | A paid ad awaiting payment |
| removed_by_user | Taken down from the OLX account |
| removed_by_moderator | Taken down by OLX |
| blocked | Blocked by OLX |
limited and moderated are the two worth watching. limited means you have hit your free-ad ceiling and further ads will not go live until you buy more capacity in OLX. moderated is normal for a first publish in a new category and usually clears on its own.
Free ad limits and promoting ads
OLX gives each account a number of free ads and charges beyond it. When you cross the line easySales shows a message and new ads take the limited status — nothing is lost, but nothing publishes until you add capacity in your OLX account.
Promotion is done in OLX, not in easySales. Bumping an ad to the front page, featured placement and paid boosts all live in your OLX account. easySales publishes and maintains the ad; how prominent it is remains an OLX decision.
If syncing stops
Almost every broken OLX connection comes down to authorization, and most often to the 30-day expiry above. Open the connection and use Reauthenticate with OLX — that resolves an expired session, a revoked approval, or a password change on the OLX side. Your mapping and your linked ads survive it, so re-authenticating is always preferable to deleting the connection and starting again.
If you would rather not be caught out, treat the expiry email as a monthly task: re-authenticate when it arrives rather than when ads stop.
If ads publish but are rejected, the cause is usually the ad rather than the connection: an unmapped subcategory, a title over the character limit, or a required category attribute left empty.