Changelog

Changes to the Customnia Partner API that partners should know about. Additions do not break existing clients; anything that would is announced here at least 30 days ahead and comes as a new version (/v2).

Addresses — 2026-11-11

• Buyers' GET /account has addresses: the recent distinct shipping addresses of their paid orders, through the API and on customnia.com with the same email; orders show their shipping_address (CUSTOMNIA-677). MCP get_account tells the agent to offer them before asking.

Directories — 2026-11-11

• Buyers get ready for real orders on a Customnia page: setup_url (in GET /account, and in phone_required and card_required answers) opens a page where the person confirms a phone by SMS and saves a card on Stripe. MCP: setup_payments replaces start_phone_check, confirm_phone and add_card, so no codes pass through the chat (CUSTOMNIA-672). The REST endpoints stay.
• Every MCP tool states readOnlyHint, destructiveHint and openWorldHint; OAuth answers carry iss (RFC 9207).

MCP connectors — 2026-11-11

• https://api.customnia.com/connect: the MCP server for ChatGPT, claude.ai and other apps whose connectors sign in with OAuth instead of a key (CUSTOMNIA-666). OAuth 2.1 with dynamic client registration and PKCE (S256); the person signs in with an email code (new ones are signed up) and picks test or real orders. Discovery at /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server.

1.7.0 — 2026-11-11

• Designs from words: POST /designs with text, font (from the new GET /fonts: the designer's fonts), text_color, bold, italic, text_side makes a transparent print-wide PNG (CUSTOMNIA-663).
• remove_background on POST /designs takes the background off the pictures first.
• MCP: list_fonts; create_design takes words and remove_background.

1.6.0 — 2026-11-11

• Buyers set their own webhook: PATCH /account with webhook_url (public https) answers the webhook_secret once; new_webhook_secret replaces it (CUSTOMNIA-664). Deliveries to buyers' URLs go only to public addresses, without redirects.
• Buyers: the options of customnia.com's payment step in quotes and orders — review_design (a designer checks the artwork, at the website's price), print_as_is, tip and promo_code; totals show tip, design_check and promo (CUSTOMNIA-662). The order lands in Valera with them, as a website order would.

MCP sign-up — 2026-11-11

• /mcp without a key offers start_signup and verify_signup: an agent signs a person up as a buyer and gets their keys, then reconnects with a key (CUSTOMNIA-632). A wrong key is still refused.
• Opening https://api.customnia.com/mcp in a browser shows what the server does and how to connect; AI tools that read the link get the same as Markdown (also at /docs/mcp.md). MCP clients are not affected.

Docs — 2026-11-11

• Order by API: the guide for people and AI agents ordering for themselves, and /docs/order.md, the same as step-by-step instructions for an agent (also the MCP resource customnia://docs/order.md) (CUSTOMNIA-632). The store guide links to it. Docs pages no longer scroll sideways on phones.

1.5.0 — unreleased (buyers: payments)

• POST /account/card: a Stripe page where the person saves a card once; GET /account shows it. A buyer's live order is charged to it for the quote total, then placed; 402 card_required, card_declined or authentication_required with action_url when the bank wants the person to confirm. A retry with the same reference never charges twice; cancelling before printing refunds the card (CUSTOMNIA-632).
• MCP: add_card; place_order places a buyer's live order.

1.4.0 — 2026-11-11 (buyers preview)

• Groundwork for people and AI agents ordering for themselves (CUSTOMNIA-632): POST /signup, /signup/verify, GET|PATCH /account, POST /account/phone, /account/phone/verify; retail quotes with quantity discounts, printing speed, tax and shipping; expected_total on buyers' orders. Sign-up is closed until announced; nothing changes for store keys.
• Store keys: totals gain discount and tax (always 0 for stores). GET /account tells a key whose it is.
• Fix: the 240 requests a minute limit now counts per key, as documented; it counted per IP address before.
• MCP: every tool on one page of tools/list; get_account.

MCP server — 2026-11-11

• https://api.customnia.com/mcp: the API as an MCP server for AI agents, with your key (CUSTOMNIA-629). Tools for the catalog, designs, mockups, quotes and orders; place_order and simulate_order with a test key only, claim_designs with the live key only. No changes to /v1.

Fix — 2026-11-11

• POST /designs/claim: a design nothing marks as anyone's is claimed only by partners Customnia allowed to; others get not_marked in rejected (CUSTOMNIA-631). Partners that existed before keep claiming as before.
• seller.logo_url is fetched only from public hosts, without redirects, at most 5 MB (CUSTOMNIA-631).
• POST /designs/{id}/editor-link answers 503 designer_unavailable while the designer cannot take links, instead of a link that does not open (CUSTOMNIA-630).

Docs — 2026-11-10

• Step-by-step instructions for moving a project off the old design API, written so a coding agent can follow them: /docs/migration.md (CUSTOMNIA-622). /llms.txt sums up the API for AI agents. No API changes.

1.3.0 — 2026-11-05

• POST /designs/text/replace: a text changed in your designs at once — the words (and font) to find, the new words, and the colors for light and dark garments (CUSTOMNIA-576). The last call of the old design API (customize-blanks/text/replace) now has its place here.

1.2.0 — 2026-11-05

Everything the old design API (design.customnia.com/api) did, with your key (CUSTOMNIA-563).

• Catalog filters: GET /catalog?category=&brand=&color=&size=&label=, a filters list of their values, and GET /catalog/{blank_id}. Blanks gain brand, sku, category_id, labels, has_front, has_back, size_chart_url, printing_speeds, retail_price_from, platen; sizes sku; colors sku, dark, text_hex, print_location_id, same_day, moq.
• Designs from designer layers: POST /designs takes front_layers / back_layers (fabric.js canvas), alternative, color_id, notes as JSON.
• Designs show customized_blank_id, color, layers, previews, print_files, editable, origin, test, notes.
• GET /designs (paginated, customized_blank_ids= finds old ids), PATCH /designs/{id} (layers, files, color, notes), POST /designs/{id}/copy, POST /designs/{id}/layers/copy, POST /designs/media/replace.
• POST /designs/claim: take over designs made through the old design API by their id; nobody else can then reach them.

1.1.0 — 2026-11-03

• Test mode: a cn_test_… key places orders that are never printed or charged; POST /orders/{id}/simulate moves them through their statuses and sends the usual webhooks. Orders have test: true|false.
• Back print: blanks with back_print_area, per color back_photo, back_photo_print_area, back_print_price; back_file on POST /designs; sides, back_print_file_url, back_mockup_url_template on designs; ?side=back for mockups. A back-only design is priced without the front print.
• Orders without warehouse_id go to Los Angeles for western states, New York for the rest (was: always New York).
• White label: seller.logo_url and seller.packing_note for the packing slip.

1.0.0 — 2026-11-02

First version.

• Catalog with partner prices: blanks, colors, sizes, photos and where the print sits on them.
• Designs from a PNG or empty for Customnia's designer; mockups per color; signed designer links.
• Quotes; orders that are safe to retry (reference); cancel and change the address until printing starts.
• Order statuses received, printing, ready, shipped, delivered, cancelled.
• order.updated webhooks with signatures; GET /orders?updated_since= as a safety net.