Nucleo Developers
Build on Nucleo
The APIs your storefront, your warehouse and your AI assistant use to work with Nucleo — with guides, OpenAPI 3.1 specifications and copy-ready code samples.
API reference
Every API that is live in production, grouped by module.
Authorization server for apps and AI assistants that act on behalf of a Nucleo user.
One remote MCP server that gives Claude, ChatGPT and other AI clients the Nucleo tools of a user.
List and run the Nucleo tools of one module for an AI client acting on behalf of a user.
Tell shoppers when an item or cart will arrive, before they buy.
Let shoppers find their order and create a return, exchange or store-credit request.
Public parcel tracking for shoppers, and the inbound webhook carriers use to report tracking events.
T-Data compatible /V1 facade that a warehouse management system polls to fulfil Nucleo Commerce orders and returns.
FFW / Smart Shop compatible XML web services that a warehouse management system calls to fulfil Nucleo Commerce orders and returns.
Start here
- Getting startedWhat you can build on Nucleo, where each API lives and how to make your first call.
- AuthenticationThe five kinds of credentials Nucleo uses, where to get each one, and how to keep them safe.
- Rate limitsHow many requests each API accepts, how limits are counted and how to back off.
- ErrorsStatus codes, error bodies and which errors are worth retrying.
- Versioning and stabilityHow APIs are versioned, what Beta means and where changes are announced.
- WebhooksThe calls Nucleo makes to your endpoints, and how carriers push tracking events into Nucleo.
Integration guides
- Send storefront eventsConnect your storefront to Nucleo Catalog with the Collector: install, consent, custom events and testing.
- Delivery promise, returns and tracking on your storefrontShow when an order will arrive, let shoppers return items and follow their parcel — inside your own storefront.
- Connect a warehouseHand orders to your warehouse system and get back shipments, stock and returns, with a T-Data or FFW compatible interface.
- Build a website on the Brain CMSRead published pages, entries and menus from your website's server and refresh on publish.
- Connect an AI assistantGive Claude, ChatGPT or your own agent access to Nucleo with the MCP connector, with each person's own permissions.
Resources
OpenAPI specifications
Import them into Postman, Insomnia or your code generator. Each file is the source of the reference above, so the two never drift apart.
| API | Module | Version | File |
|---|---|---|---|
| OAuth & OpenID Connect | Platform | 2026-10 | oauth.yaml |
| MCP Connector | Platform | 2026-10 | mcp.yaml |
| AI Tools | Platform | v1 | ai-tools.yaml |
| Collector | Catalog | v1 | collector.yaml |
| Delivery Promise | Commerce | v1 | delivery-promise.yaml |
| Returns Portal | Commerce | v1 | returns.yaml |
| Shipment Tracking | Commerce | v1 | tracking.yaml |
| WMS T-Data | Commerce | v1 | wms-tdata.yaml |
| WMS FFW | Commerce | 2026-10 | wms-ffw.yaml |
| Content Delivery | Brain | v1 | content.yaml |