Pre-launch API. The concepts described here are settled, but the API shape is not: request and response fields, parameters and defaults can still change. Build against it, and talk to your Luigi's Box contact before you put an integration into production.
The Hub is the browser console for your account, at
https://hub.<region>.luigisbox.ai — https://hub.eu1.luigisbox.ai for the EU region.
Sign in with the same Luigi’s Box account you use everywhere else; there is nothing
separate to provision.
Much of what this documentation shows as an API call can be done there instead. Where that is true, the page carries an In the Hub panel next to the call. It gives the click path as a trail — the section, the page, and the control you press — and says what the form does not cover.
What it covers
Section titled “What it covers”| In the Hub | Does what | Written up under |
|---|---|---|
| Front-end Integration | Creates integration repositories, renames them, hands you the clone URL and the loader script URL, and shows the one-off git setup for cloning on macOS, Linux, Windows and WSL | Repositories API, Quickstart |
| Channels | Creates, edits and deletes channels — name, catalog, visibility conditions, attribute projections | Account structure |
| Business Rules | Authors campaigns end to end: targeting, triggers, schedule, disclosure, rules and effects, and the draft → active → paused → archived moves; a saved campaign’s Overview sums it up as cards or as a flow, illustrates what its rules do and edits each part in place | Authoring API |
| Data preview | Browses a catalog’s object types and objects, finds one by its ID, and shows each object’s stored attributes as raw JSON and its change timeline | Catalog metadata, Object history |
| Catalog Management | Lists catalogs with their sources and channels, and opens one to its object types, feeds with sync history and mappings; renames a catalog and triggers a manual sync | Feed management API |
| Collections | Creates, lists and deletes a catalog’s curated collections, and edits each one’s filter | Account structure |
| Search | Reports how search and autocomplete perform over a date range, segmented by traffic source, device or any session field and compared with the previous period: Overview sums up revenue, conversion and the funnel, and what is winning or needs attention; Queries and Results rank the top queries and results, with a page for each; Results breakdown splits results by type and segment | What you can report on |
What it does not cover
Section titled “What it does not cover”These have no form in the Hub, and are done over the API:
- Sending catalog content — the Content API and feeds, including feed configuration and mappings.
- Creating organizations, catalogs, surfaces, tags and membership collections — Account structure.
- Discovery requests — search, collection and recommendations.
- Reporting behaviour — sending events.
- Issuing and rotating credentials — Authentication.
Which one to reach for
Section titled “Which one to reach for”The Hub and the API write the same records, so a channel created in one is the channel the other reads. Use whichever suits the job:
- The Hub for one-off setup and for anything a person decides — creating the integration repository, adding a market as a channel, running a merchandising campaign.
- The API for anything that has to repeat: provisioning per environment, campaigns generated from your own merchandising tooling, or configuration you keep in version control.
When a save is refused
Section titled “When a save is refused”The Hub acts with your account’s own permissions, checked exactly as an API call is, so it can change only what you are granted. Saving an edited channel needs permission to update channels, granted on that channel, its catalog or its organization. Without it the save is refused with “You don’t have the necessary permissions to update channels” and the form stays open with your changes. Grants are configured by Luigi’s Box, so ask them for the permission rather than retrying.
Interface language
Section titled “Interface language”The Hub is available in English, Slovak, German and Polish. On your first visit it opens in your browser’s preferred language when that is one of the four, and in English otherwise.
To change it, open the language menu in the header — on the sign-in page too — and pick English, Slovenčina, Deutsch or Polski. On a narrow screen the same choice is under the ⋮ menu, as Language. The Hub remembers the choice in that browser, so another browser or device starts from its own preferred language.
The setting changes only the Hub’s own text, plus how it formats dates and numbers. Your catalog data, campaign names and anything else you entered stay as you wrote them.
Passkeys
Section titled “Passkeys”Every passkey must verify you when you sign in — with your fingerprint, your face, your device’s PIN, or the PIN of a security key. A security key without a PIN cannot sign in until you set one; your browser offers to set it when it is needed.
Keep at least two passkeys, on different devices, so losing one does not lock you out. Add and
remove them on the passkey page, https://auth.<region>.luigisbox.ai/passkeys/manage. Each change
there asks you to confirm with a passkey first.
If your account’s email address was never confirmed, signing in with Google confirms it and removes any passkeys on the account, since nobody proved the address when they were added. Add a new one afterwards.
If you lose your passkey
Section titled “If you lose your passkey”If you lose every passkey, choose Recover your account on the sign-in page and enter your email address. We email you a link, valid for 24 hours; open it on the device you sign in with. Your organization’s security contact — a person your organization agreed with Luigi’s Box — is then texted a link to approve the recovery. Reach them yourself so they expect it; Luigi’s Box never contacts them on your behalf. The text can be sent to them at most three times per recovery. Ask from the device and browser you will set up the new passkey on: once you have asked, the link opened anywhere else can ask only an hour later. Once they approve, set up your new passkey within an hour. Every passkey you had before stops working, you are signed out everywhere, and the security contact and everyone in your organization are told.
If you are the security contact, approve only after you have reached the person yourself, on a number you already had, and they confirmed it is them. Luigi’s Box never calls or writes to ask you to approve. If you choose This wasn’t them, nobody can recover that account for the next 24 hours.
An account can be recovered once every 30 days. If you sign in with Google, sign in that way instead. If your organization has no security contact, the email says so. If no email arrives at all, your account may not be set up for recovery yet. Either way, ask your account manager.
See also
Section titled “See also”- Account structure — the entities the Hub edits
- Your first integration — the fastest path to a storefront
- Authentication — the credentials behind both surfaces
Was this page helpful?
Thanks.