What we do
Tools
Industries
Department
How we workLet's talk →
Home/Katana
Katana Cloud Manufacturing API

Katana API: Sales Orders In, Manufacturing Orders Done, and the Webhooks in Between

A wholesale buyer's order sits in an inbox while the floor builds from what's already in Katana. Katana's open API is a REST API at api.katanamrp.com/v1 with a Bearer API key, covering sales orders, manufacturing orders, purchase orders, stock and more, plus webhooks that fire when an order is created, a build is done or a material runs out. You'll need a Professional plan or higher to use it.

Where Katana stops

Native Shopify and WooCommerce sync helps, but custom logic and other systems mean someone checks three tools by hand.

Stuck on Katana? Let's solve it →
The Katana API in five lines

Plan: Professional or higher, according to Katana's getting-started guide.

Key: generate one in Katana's settings. Keep it on your server, never in browser code.

Settings API API keys + Add new API key

First call: GET https://api.katanamrp.com/v1/sales_orders with Authorization: Bearer YOUR_KEY. Without a valid key, Katana answers 401.

Limit: 60 requests per 60 seconds by default. Watch X-Ratelimit-Remaining, and when a 429 arrives, wait the seconds in Retry-After.

Building an app for other Katana users? That needs OAuth 2.0, set up through Katana's App Partners team, rather than an API key.

Katana webhook events, matched to the job each one starts

Each event posts a small JSON body (resource type, action, webhook ID, and the object's id, status and href), so the handler fetches the full record before acting.

When you need to know Subscribe to What the integration then does
A sales order was entered, on screen or by a channel sales_order.created Copies it to the CRM or confirms it to a buyer whose portal Katana has no connection to.
An order has been packed or delivered sales_order.packed, sales_order.delivered Updates the status the buyer sees on their own portal or in your CRM.
A build is finished manufacturing_order.done Tells sales the order can ship, or records finished goods where your reporting needs them.
A material has run out current_inventory.material_out_of_stock Reaches a supplier or buying tool that lives outside Katana.
Goods from a supplier have arrived purchase_order.received Updates the receiving or cost record in the other system that tracks it.

Katana integrations that slip once real orders flow

The same order created twice

How you'll know: A timeout, an automatic retry, and two identical sales orders on the floor's list.

Fix: Before creating, list sales orders filtered by order_no or ecommerce_order_id, and only create when nothing matches.

A webhook handler that thinks too long

How you'll know: The same event arrives several times, each with an X-Katana-Retry-Num header.

Fix: Answer with a 20X within 10 seconds and do the work afterwards from a queue. Katana retries three more times, at about 30 seconds, 2 minutes and 15 minutes, then stops, so use the webhook log export to find anything missed.

Any POST to the endpoint is trusted

How you'll know: The handler acts on whatever reaches its URL.

Fix: Check the x-sha2-signature header: an HMAC SHA-256 signature made with the token Katana returned when the webhook was registered.

Actual usage sent after the build is closed

How you'll know: Updates to ingredient quantities are refused once the manufacturing order is Done.

Fix: Record actual quantities on the recipe rows, or as partial productions, before setting the order to DONE. After that, its recipe rows can't change.

Katana the software, and its open API

What is Katana software?

Katana, also called Katana Cloud Manufacturing, is cloud software for small and mid-sized manufacturers. It tracks raw materials, work in progress and finished goods live, holds bills of materials, and schedules production, so the stock figure isn't only right the day after a count.

Is Katana an ERP or an MRP?

Closer to an MRP. Katana is strong on inventory and production and leans on integrations with your accounting software and sales channels for the finance and selling sides that a full ERP would try to own itself.

How much does Katana cost?

Katana sells tiered monthly plans that scale with features and usage, and the prices change, so check its pricing page. If you plan to use the API, note that Katana's developer guide puts API access on the Professional plan or higher.

What does Katana integrate with?

Natively, with e-commerce platforms such as Shopify and WooCommerce, accounting software such as QuickBooks Online and Xero, and other tools through its integration marketplace. A buyer portal, an EDI partner or an unusual accounting setup outside that list is where the API comes in.

Where do I log into Katana?

Through the login page on katanamrp.com, which opens the app at app.katanamrp.com, using the account your organization set up.

Does the Katana API support webhooks?

Yes. You register them through the API and choose events such as sales_order.created, manufacturing_order.done or purchase_order.received. Each request is signed, and Katana retries an unacknowledged one three times.

Who builds integrations on the Katana API?

Getting a key to work takes minutes. The build is everything after it, and that's the part n-frames takes on: the order intake that checks for an existing order before creating one, signed webhook handlers that acknowledge within Katana's 10 seconds and queue the work, and rate-limit pacing so a busy morning doesn't end in 429s.

A contract manufacturer whose wholesale orders stopped being retyped

A contract manufacturer that plans and tracks production in Katana and sells through its own website plus two wholesale accounts.

Before

Wholesale orders arrived by email or through a buyer's portal that Katana didn't connect to.

Someone re-keyed each one into Katana as a sales order, checked it against stock, and later emailed the buyer once it was scheduled for production.

After

Wholesale orders now land in Katana as soon as they arrive, checked against live stock and production capacity.

The buyer gets a confirmation without anyone touching the order in between.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.