Skip to main content
@spree/admin-sdk is the official TypeScript SDK for the Admin API v3 — the back-office counterpart to @spree/sdk. Use it to build integrations, automations, internal tools, and custom admin UIs: manage products, orders, customers, stock, promotions, webhooks, and more.
@spree/admin-sdk 1.x works with the Spree 6.0 Admin API. Check the changelog when updating.

Installation

Quick start

Create a client with a secret API key (server-to-server) and start calling resources:
Every method is fully typed — responses use types generated from the API serializers:
Secret keys grant back-office access — never ship them in browser code. For browser-based admin apps, use JWT cookie authentication instead.

Learn more

Authentication

Secret keys with scopes for servers, JWT + httpOnly refresh cookie for browser apps.

Resources

The full resource map — products, orders, customers, stock, promotions, webhooks, and more.

Querying & Errors

Filtering, sorting, pagination, prefixed IDs, and structured error handling.

Admin API Reference

The underlying REST API the SDK wraps — every endpoint, parameter, and response shape.
Adding your own resources? The spree generate api_resource generator scaffolds Admin API endpoints (model, serializers, controllers, specs) in one command, and the extending guide shows how to call custom endpoints from the SDK.