Everything you need to integrate with Allegro's REST API. Authentication, key endpoints, rate limits, and webhooks — explained for e-commerce sellers and developers.
The Allegro REST API is the primary programmatic interface for integrating with Poland's largest e-commerce marketplace. With over 20 million active buyers and 135,000 merchants, Allegro processes billions of zloty in gross merchandise value annually. The REST API replaced the legacy WebAPI (SOAP) in 2020 and is now the only supported integration method for new applications.
The API follows RESTful conventions with JSON payloads, uses OAuth 2.0 for authentication, and provides comprehensive coverage of the seller workflow: listing products, managing orders, handling returns, uploading images, and monitoring account health. All endpoints are documented at developer.allegro.pl, Allegro's official developer portal.
For sellers expanding to European marketplaces, Allegro's API is critical infrastructure. Unlike platforms such as Amazon (which uses SP-API) or eBay (which uses a combination of REST and legacy APIs), Allegro's modern REST API is relatively straightforward to integrate with — but it has unique conventions around product-based offers, category-specific parameters, and the Polish-language category tree that require careful handling.
This guide covers the essential concepts you need to build a working Allegro integration: obtaining API credentials, authenticating requests, creating and managing offers, processing orders, and subscribing to real-time events. Whether you are building a custom integration or evaluating tools like Marqetir that handle the API complexity for you, understanding these fundamentals will help you make informed decisions.
Last updated: March 2026
Allegro uses OAuth 2.0 exclusively. There are no API keys or basic auth options. To get started, register your application in the Allegro Developer Portal (apps.developer.allegro.pl). You will receive a client_id and client_secret.
For applications acting on behalf of a user. The seller authorizes your app through a browser redirect, and you exchange the authorization code for access + refresh tokens. Access tokens expire after 12 hours; refresh tokens after 3 months.
For server-to-server calls that don't require user context (e.g., browsing categories, searching public offers). The token is obtained by posting your client_id and client_secret to the token endpoint.
Token endpoint:
POST https://allegro.pl/auth/oauth/tokenInclude Authorization: Basic {base64(client_id:client_secret)} in the header.
The Allegro REST API base URL is https://api.allegro.pl. The sandbox environment uses https://api.allegro.pl.allegrosandbox.pl. Below are the endpoints most critical for seller integrations.
| Method | Endpoint | Description |
|---|---|---|
| POST | /sale/product-offers | Create or update a product-based offer |
| GET | /sale/offers | List your active offers with filters |
| GET | /sale/categories | Browse the full category tree |
| GET | /sale/matching-categories | Find matching categories by keyword |
| GET | /order/checkout-forms | Retrieve orders and checkout data |
| PUT | /order/checkout-forms/{id}/fulfillment | Update shipment and tracking info |
| GET | /sale/offer-events | Poll for offer change events |
| POST | /sale/images | Upload product images |
| GET | /pricing/offer-fee-preview | Preview fees for an offer before listing |
| GET | /me | Get current user account details |
Create a business seller account at allegro.pl. You need a valid Polish or EU business registration (NIP/VAT ID). Verify your identity and complete the onboarding process, which typically takes 1-3 business days.
Go to apps.developer.allegro.pl and register a new application. Choose "Web application" for server-side integrations. Set your redirect URI (used during OAuth authorization). You will receive your client_id and client_secret.
Use the Authorization Code flow to obtain access and refresh tokens. Store the refresh token securely — you will need it to obtain new access tokens when they expire (every 12 hours). Implement automatic token refresh in your integration.
Allegro provides a full sandbox at allegro.pl.allegrosandbox.pl. Register a separate sandbox application, create test offers, and simulate the complete order flow before going live. The sandbox mirrors production behavior but uses test data.
Use the /sale/matching-categories endpoint to find the right category for each product. Allegro requires category-specific parameters (attributes) for each offer — retrieve these with /sale/categories/{id}/parameters. This mapping is the most time-consuming part of the integration.
Use POST /sale/product-offers to create a product-based offer. Include the required category parameters, at least one image, a title (up to 75 characters), description (HTML allowed), price, stock quantity, and shipping rates. The API returns the offer ID and its activation status.
Skip the OAuth flows, rate limit handling, and category mapping. Marqetir connects to Allegro's API and manages your listings automatically — so you can focus on selling.
Free 7-day trial • No credit card required • Cancel anytime
Common questions about integrating with the Allegro REST API.