BBehioAI-native
For developers

Build on Behio.
One small SDK.

Our Developer SDK is a clean TypeScript package that turns your Behio shop into a programmable API. Build your own storefront, wire up your own integrations, embed Behio into another site, connect your own AI agents. All with one install.

Open SDK docs →npm install @behio/storefront-sdk
What you can build

Six things developers do with one SDK.

01

Build your own storefront

If our generated shop is not enough, build the front end yourself. The SDK reads your products, categories, prices and stock. You ship the experience.

const products = await shop.products.list({
  category: "mugs",
});
02

Place orders from anywhere

Hook up the checkout from a mobile app, a kiosk, a marketplace listing. One method on the SDK creates the order. Behio handles invoicing and stock on its own.

await shop.cart.checkout({
  items, customer, payment,
});
03

Read your own data

Customers, orders, invoices, shipments. Every part of Behio that you see in the admin is available through the SDK with a scoped token.

const invoices = await shop.invoices.list({
  from: "2026-01-01",
});
04

Sync with anything

Connect Behio to your accounting, your CRM, your warehouse software. Two way sync without scraping screens or polling spreadsheets.

shop.on("order.created", (o) =>
  xero.invoice.create(o),
);
05

Plug AI agents in

Your own Claude or in-house model reads orders and updates stock through the same SDK. Scoped tokens, audit log, full transparency.

const mcp = shop.toMcpServer({
  scope: ["read:orders"],
});
06

Embed Behio in a website

Drop a buy button, a product carousel, or a full catalogue into any site. The SDK ships a small set of unstyled components you wrap with your own design.

<BehioBuyButton
  productId="linden-mug-01"
/>
A taste

Three lines to a working order. The whole shop is just like this.

Initialise the client, read a product, place an order. Stock, invoicing, shipping happen on the Behio side automatically. You ship the experience, we handle the bookkeeping.

  • TypeScript first. Full types for every entity.
  • Works in browsers, Node, Bun, Deno, edge runtimes.
  • Zero peer dependencies. Lean bundle.
  • Same auth flow as the Behio app, scoped tokens.
  • Open source. MIT license. Read every line.
  • Versioned with semver. We break things in major releases only.
import { BehioClient } from "@behio/storefront-sdk";
 
const shop = new BehioClient({
storeId: "atelier-clay",
token: process.env.BEHIO_TOKEN,
});
 
const linden = await shop.products.findBySlug("linden-mug");
 
const order = await shop.cart.checkout({
items: [{ productId: linden.id, quantity: 2 }],
customer: { email: "eva@example.com" },
});
 
console.log(order.invoiceUrl); // invoice ready in your Behio admin
Who reaches for it

Three kinds of developers are already on it.

Agencies

Building a bespoke shop for a client. Behio handles the back office, you handle the brand.

Internal teams

Your own engineers want to plug Behio into the existing stack. Same SDK, scoped tokens, no scraping.

Tinkerers

Side project, side shop, side experiment. The SDK is open source. Run it on your own infra if you want.

Curious how Behio is built underneath the SDK? Read the architecture page.

Read the docs. Ship in an afternoon.

Open SDK docs →See it on npm