Connecting Allegro

Only a Global Admin can open Sales Channels. You need an active Allegro seller account on allegro.pl.

Connecting lets Sugibana Flow import your Allegro orders, keep stock in sync and publish ready SKUs as offers. Flow connects your Allegro account on allegro.pl (PL).

You connect with your own Allegro developer app: there is no shared Sugibana Allegro app. You register the app at Allegro's developer portal, add Sugibana Flow's redirect address to it, then save its Client ID and Client secret in Flow. Flow checks them with Allegro before it saves them.

Connecting Allegro: 1. Register your app (Allegro developer portal) → 2. Add the redirect address (copied from the Allegro drawer) → 3. Save keys (Client ID, Client secret, Environment) → 4. Connect Allegro (sign in as seller, you return by yourself) → 5. Validate Connection (then Order import and Stock push).

How do I connect Allegro?

  1. Register an app at Allegro's developer portal, developer.allegro.pl. For a test connection, register a sandbox app and choose Sandbox as the Environment in step 5. Note the app's Client ID and Client secret. The exact portal menu names are not covered here; follow Allegro's own getting-started guide.
  2. Open Sales Channels. It is a list of channels. Click the Allegro row, or its Connect button while not connected. A side drawer opens; ?tab=allegro opens it directly.
  3. Under Ways to connect, find Your own Allegro developer app (You will need: a Client ID and Client secret from your app at Allegro's developer portal, with Sugibana Flow's redirect address added to it). Click Connect to open the form.
  4. Copy the Redirect address (the copy button is next to it) and add it to your Allegro app's redirect addresses at the developer portal. Where that setting sits in the portal is not covered here.
  5. Enter the Client ID and Client secret, choose the Environment: Production for your real offers or Sandbox for test data. Save keys stays disabled until both are filled. Click Save keys.

Screenshot: The Allegro drawer after clicking Connect on Your own Allegro developer app: the form with Client ID, Client secret, Environment (Production or Sandbox), the Redirect address with its copy button, and the Save keys button.

  1. Flow checks the keys with Allegro. On success you see Keys saved. Now connect Allegro to sign in with your seller account.
  2. Click Connect Allegro (it reads Redirecting… while it leaves), sign in with your Allegro seller account and approve the request. The card's own checklist lists the permissions allegro:api:sale:offers:write and allegro:api:orders:read.
  3. You return to the Allegro drawer. Under Account, the badge shows Connected. Click Validate Connection: Connection validated successfully appears with your Allegro login and country, and the badge becomes Active.

Screenshot: The connected Allegro drawer with Account open: Connected via Your own Allegro developer app, the Connected badge and Validate Connection, the Client ID with Production and a Replace keys link, and the connected account's marketplace and token expiry dates.

While your first channel is still being set up, the page can show "Your setup window is still active — you can add more channels …" (until a time, or once your primary channel syncs). After that, clicking Connect Allegro can first ask "Is [your primary channel] working as expected?". Answer No — it’s not working to open a case, or Yes to carry on.

What does the Allegro drawer show?

Once connected, the drawer has these sections, top to bottom. Status and Features start open; click a section to open it.

  • Status: Shadow mode badge if stock is compared but not pushed, the readiness matrix and API access and permissions.
  • Features: Order import, Stock push, Auto-revive ended offers (see below), the Ship-confirm switch ("Ship-confirm: send tracking & mark shipped on Allegro"; it stays off and reads "Coming soon — Sugibana switches this on per channel." until Sugibana switches it on for this channel) and Access health: OK · checked …, Not verified or Access lost: … per feature, the last with an Open the case link.
  • Account: Connected via "Your own Allegro developer app", the Validate Connection button, your Client ID with its environment, Replace keys, and the Connected account box.
  • Danger zone: Disconnect.

How do I turn on order sync and stock push?

  1. In the Allegro drawer, under Features, switch on Order import. Every Allegro order is then fetched about every 5 minutes.
  2. Switch on Stock push to send your Available quantity to Allegro whenever it changes.

If Stock push shows Unavailable and a lock, stock push is not yet enabled on the platform for Allegro. Nothing is sent to your live offers, and the switch cannot be turned on until it is. A Shadow mode badge means quantities are compared but not pushed.

Stock push only reaches SKUs that are mapped to this account's Allegro offers.

Flow works out each order's status from Allegro's order and fulfilment state:

  • Pending: the buyer has not finished checkout or payment yet.
  • Unshipped: paid and still to ship (including suspended and ready for pickup).
  • Shipped: sent, or picked up by the buyer.
  • Cancelled: the order or its fulfilment is cancelled.

An order with an Allegro state Flow does not know is held back and raises an incident instead of guessing.

An Allegro offer ends the moment its stock reaches 0. See why an Allegro offer did not come back for the Auto-revive ended offers switch.

Does the Allegro connection expire?

Yes. The access Flow holds for each call is renewed by itself, but the sign-in itself lasts about three months (90 days). Under Connected account, Refresh token shows the date, and under 30 days it reads Reconnect within N days. To renew, click Disconnect, confirm, then connect again from the drawer. Disconnect deletes your stored app credentials, so expect to save the Client ID and Client secret again before Connect Allegro. When the sign-in expires, order import and stock push stop until you reconnect.

The Connected account box also shows the Environment (Production for your real offers; a Sandbox connection holds only test data and cannot see real orders) and the marketplace.

How do I replace my app keys?

Under Account, click Replace keys, enter the new Client ID and Client secret, and click Save keys. Changing only the secret keeps your connection. Switching to a different app or environment disconnects it: click Connect Allegro again afterwards. Click Cancel to keep the current keys.

I got an error. What now?

  • Allegro rejected this Client ID or Client secret. Check them in your Allegro app and try again.: the keys do not match your Allegro app. Check them, and that the Environment matches the app, then click Save keys.
  • Could not reach Allegro to check the keys. Try again in a moment.: Flow could not reach Allegro; nothing was saved. Try again.
  • Save your Allegro app keys first.: you clicked Connect Allegro (or returned from Allegro) with no saved keys. Save them, then connect.
  • Your Allegro app keys were replaced while you were signing in. Click Connect Allegro again.: the keys changed during the sign-in. Click Connect Allegro again.
  • Back on the Allegro drawer but still Not connected: click Connect Allegro again, then Validate Connection.
  • Allegro itself refuses the sign-in (for example, a redirect address mismatch): check that the Redirect address in the drawer is added to your Allegro app exactly. Allegro's own wording for this error is not covered here.

How do I disconnect Allegro?

In the Allegro drawer, open the Danger zone, click Disconnect and confirm with Yes, disconnect. Orders and stock stop syncing with Allegro, and your stored app credentials are deleted. Your products, orders and history stay, and you can reconnect any time. Your offers on Allegro stay live with their last quantities; end them on Allegro if you no longer want to sell, or they can oversell.

For everything else about channel connections, see Adding a sales channel and keeping its connection healthy.

Signed in? Open this guide with its screenshots in your Help Center.