Kentro API reference

The Channel API, the Store API and Kentro Pixel: what each one is for, how authentication works and where to get help.

Kentro is the operating system for B2B commerce: one system of record for orders, customers, products, inventory, fulfillment, shipping, invoices and payments across every sales channel a tenant runs, with storefronts, a 3PL network and EDI on top. This section is the reference for the three ways a system or a storefront works with Kentro.

📘

New to Kentro?

The developer center starts with concepts, API keys and a first request, then walks through each kind of integration, including building one with an AI agent.

Channel API

The Channel API moves a sales channel's data into and out of Kentro: orders, customers, products and listings, inventory, fulfillment orders, shipments, invoices, payments and purchase orders. It is for integrations: marketplaces, carts, EDI, 3PLs, ERPs and WMSs. Kentro is the system of record; the caller is a system.

Store API

The Store API is Kentro's storefront infrastructure (buyer sign-in, the catalog with the buyer's prices, cart, quotes, checkout, orders, invoices, account, subscriptions) for a tenant who builds their own storefront UI instead of using the templates in Kentro OS > Storefront. The caller is the tenant's storefront server, acting for one buyer at a time.

Kentro Pixel

Kentro Pixel is first-party, consent-aware measurement. A browser SDK and a server events API record what visitors and customers do on the tenant's own sites and systems, and a management API runs properties, destinations, analytics and privacy requests.

  • Collector: https://pixel.kentro.live (sandbox https://pixel.kentro.dev)
  • Start here: Kentro Pixel, then the quickstart

Authentication at a glance

The Channel API and the Store API are opened by an API key created in Kentro OS under Users > API keys. A key belongs to one tenant and carries the scopes of its permission groups: channel:read and channel:write for the Channel API, storefront:serve for the Store API, admin for both.

  • Channel API: send the key pair as kentro-key and kentro-secret, or exchange it for a 15-minute bearer token at POST https://apis.kentro.live/auth/login/api-key.
  • Store API: send X-API-Key and X-Storefront-Host on every call; the buyer's token from POST https://apis.kentro.live/auth/login/customer travels as X-Storefront-Buyer.
  • Kentro Pixel: the browser SDK carries the property's public key, and server events carry a server key from the property's Keys tab in Kentro GO.

Nothing in a request selects a tenant; the key's tenant is the tenant of every call. Authentication covers every method in one place.

Support

Questions and refusals go to [email protected] with the request id from the response (X-Request-Id or requestId) and the message returned. Incident and maintenance notices come from the same address. Help with Kentro OS screens is in its Help Center, inside the app.