# Customnia Partner API

> Customnia is a print house in Long Island City, NY and Compton, CA. Stores, apps and marketplaces send it orders
> their customers already paid for; Customnia prints or embroiders them on blank garments and ships them in the
> store's name. The Partner API (REST, JSON, version 1) gives the catalog of blanks with wholesale prices, designs on
> those blanks (from a PNG or from fabric.js layers), mockups, quotes, orders and order status webhooks.

Base URL: https://api.customnia.com/v1. Every request needs `Authorization: Bearer cn_live_…` (or `cn_test_…` for
test mode: orders are checked and priced but never printed or charged). Keys are issued by hello@customnia.com and
belong on a server, never in a browser or app. Money is in US cents; times are ISO 8601. US addresses only.
Limit: 240 requests a minute per key. Errors: 401 key, 404 not found or not yours, 409 not possible now (body
`error` says why), 422 invalid input with `errors` per field, 429 too many requests.

Typical flow: `GET /catalog` (cache an hour) → `POST /designs` → `GET /designs/{id}/mockups/{color_id}.jpg` →
`POST /quotes` → `POST /orders` with your own `reference` (safe to retry) → `order.updated` webhooks (signed
`X-Customnia-Signature: t=…,v1=HMAC-SHA256(t + "." + body)`) or `GET /orders?updated_since=…`.

## Order for yourself

- [Order by API](https://api.customnia.com/docs/order): people and their AI agents order printed apparel for themselves at customnia.com's prices: sign up by email (`POST /v1/signup`), confirm a US mobile number by SMS, save a card once on a Stripe page, then quote and order without a browser; `expected_total` makes sure nothing is charged that the person did not agree to.
- [order.md](https://api.customnia.com/docs/order.md): the same as step-by-step instructions for an agent, each step with a check.

## MCP server

- [What the MCP server does and how to connect](https://api.customnia.com/docs/mcp.md); ChatGPT, claude.ai and other connector apps use https://api.customnia.com/connect and sign in with OAuth (email code)

- [MCP](https://api.customnia.com/docs#mcp): https://api.customnia.com/mcp (Streamable HTTP) with `Authorization: Bearer <key>`; tools for the catalog, designs, mockups, quotes and orders. Stores place real orders from their own server, not through MCP (test keys can place test orders); buyers' keys place real orders through MCP too. Without a key the server offers only `start_signup` and `verify_signup`, so an agent can sign a person up and get their keys.

## Docs

- [Guide](https://api.customnia.com/docs): authentication, test mode, catalog, designs, layers, copy and claim, replacing pictures and texts, mockups, designer link, quotes, orders, statuses, webhooks
- [OpenAPI 3 schema](https://api.customnia.com/docs/openapi.yaml): every endpoint, field and error; generate a client from it
- [API reference](https://api.customnia.com/docs/reference): the schema rendered for reading
- [Changelog](https://api.customnia.com/docs/changelog): versions and what changed

## Moving from the old design API

- [Migration instructions](https://api.customnia.com/docs/migration.md): step by step for a developer or a coding agent moving a project off design.customnia.com/api — find the calls, keys, claim existing designs, the call and field table, testing, cut-over

## Optional

- [Webhooks](https://api.customnia.com/docs#webhooks): retries and signature checks in PHP and Node
- [Statuses](https://api.customnia.com/docs#statuses): received → printing → ready → shipped → delivered, or cancelled