For developers

Build on top of Behio.
API, SDK and MCP.

The same platform that powers every Behio e-shop is open to you too. A typed Storefront SDK, a public REST API, webhooks and an official MCP server. No reverse engineering, no workarounds.

60+
SDK methods
25+
React hooks
42
API controllers
300+
MCP tools
app/product/[slug]/page.tsx
1import { behio } from "@behio/storefront-sdk";
2 
3export default async function Page({ params }) {
4 const { data, error } = await behio.catalog.getProduct(params.slug);
5 if (error) return <NotFound />;
6 return <ProductView {...data} />;
7}
Interfaces

Four ways to connect.

Storefront SDK

A typed TypeScript client with 60+ methods and 25+ React hooks. Zero-dependency core, optional React bindings.

catalogcartcheckoutauthreviewsreturns

Public REST API

42 controllers covering the entire catalog, cart, orders and customers. API-key authentication, rate limits per key.

RESTOpenAPIrate-limit

Webhooks

Reliable outbound webhooks with retries. React to orders, payments, restocks and stock movements in real time.

order.createdstock.changedretry

MCP server

An official Model Context Protocol server. Connect Behio to ChatGPT or Claude and run your e-shop through 300 typed tools.

MCPChatGPTClaude
Result-type API

No exceptions. Just data and error.

Every call returns { data, error } with 19 semantic error codes. The SDK knows when a retry is worth it (5xx, 429, network drop) and refreshes the token in the background.

VALIDATION_ERRORUNAUTHORIZEDDISCOUNT_EXPIREDOUT_OF_STOCKRATE_LIMITED
cart.ts
1const { data, error } = await behio.cart.addItem({
2 sku: "LEN-PRE-240", qty: 2,
3});
4 
5if (error?.code === "OUT_OF_STOCK") {
6 toast("Sold out");
7}
Quickstart

From zero to data in three steps.

01

Install the SDK

$ npm i @behio/storefront-sdk
02

Initialize the client

$ behio.init({ apiKey })
03

Fetch data

$ await behio.catalog.getProducts()