Pixelmade developers
The diamond-art print-on-demand API
Pixelmade is the print-on-demand supplier for custom diamond-art kits — and it has a Public API. Turn any design into a kit-ready product, place on-demand white-label orders with a minimum of one, and connect it to your store or to your AI coding agent. Each kit is made and shipped to your customer for one all-in price; you never hold inventory.
| API base | https://app.pixelmade.ai/public_api |
| Auth | Bearer token (pmk_… prefix) — stored hash-at-rest, rotate/revoke anytime |
| Endpoints | templates · products · DMC colors · orders · estimate · webhooks |
| Drill palette | 446 real DMC colors (GET /dmc_colors) — what you sell is what gets made |
| Rate limit | 60 requests/minute (Retry-After on 429) |
| Minimum order | 1 — made to order, DDP (kit + shipping to your customer in one price) |
| Branding | White-label — unbranded shipment to your customer |
| Agent-ready | OpenAPI 3 spec · llms.txt with runnable examples · quickstart |
What you can build
Register designs as products
Upload the production print file and get back a stable pmt_ SKU for your storefront
variant. Re-post the same slug to update a design in place — the SKU never changes. (Our design
tools solve the hard photo→chart pixelation step; the API registers the finished file.)
Sell without inventory
Create an order, get a production-time + shipping estimate, cancel if plans change. On-demand, DDP. Orders land payable in your brand portal — paying there is what releases production; the API never touches your payment method.
Track to delivery
Poll GET /orders/{id} for state + tracking numbers (a few checks a day is plenty),
or register a webhook for the shipped event if you run a server.
Build on the real catalog
Products, kit sizes, and the true DMC drill palette — the exact colors we manufacture with, so what you sell is what gets made.
Built for AI coding agents
This is the first diamond-art print-on-demand API a coding agent can actually use. Point Claude Code, ChatGPT, or Codex at these docs and it can discover the API, read the spec, and build a working diamond-art store — because we ship what agents need: an OpenAPI 3 spec, an llms.txt with step-by-step instructions and a runnable example per endpoint, and a "connect your coding agent" quickstart.
curl -s -X POST https://app.pixelmade.ai/public_api/orders \
-H "Authorization: Bearer $PIXELMADE_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"reference_number": "my_order_001",
"customer_info": {"name": "Jane Doe", "address1": "1 Main St",
"city": "Bellevue", "state": "WA",
"postal_code": "98004", "country": "US"},
"lines": [{"product_id": 1, "quantity": 1,
"artwork_location": "https://example.com/art.bmp"}]
}'
# → 201 · "state": "pending_payment" · a portal_url to pay it (paying releases production)Serious infrastructure, premium kits
The API is the interface; the product is the point. Every order is built to a premium standard — 16-facet resin square drills (not fuzzy acrylic), a pearlescent tight-weave canvas, DMC-accurate color mapping — so what your customer receives is worth a premium price and a healthy margin for you. No minimums, white-label shipping, and credentials hardened for production (tokens stored hash-at-rest, with rotate/revoke).
Quickstart
- Get an API key — open the Developer tab in your Pixelmade brand
portal, request access with a short use-case note, and generate a
pmk_…key (shown once; rotate/revoke anytime). - Make your first call — list products, register a template, place a test order (see the quickstart and reference).
- Go live — your API orders land payable in your brand portal; pay there to release each to production. (Invoice terms are available for established partners — orders then submit straight to production.)
Frequently asked questions
What can the API do?
Register kit designs as templates, look up products and DMC colors, place, estimate, and cancel on-demand orders, and track them to delivery (poll GET /orders/{id}, or a webhook for the shipped event).
How do I authenticate?
A bearer token (pmk_… prefix) you generate in the brand portal's Developer tab; stored hash-at-rest, rotatable and revocable.
Is there a minimum order?
No — one kit, made to order, shipped white-label to your customer at a single all-in (DDP) price.
Can an AI coding agent use it?
Yes — that's the design. We publish an OpenAPI 3 spec, an llms.txt with agent instructions and runnable examples, and an agent quickstart so Claude Code / ChatGPT / Codex can discover and integrate it.
How is a photo turned into a kit?
Our design tools convert the photo into a manufacturable, color-mapped chart; you then register that finished file as a template via the API.
Start building
New to selling diamond art? Start with the diamond-painting supplier hub and how to start a diamond-painting business — then automate it here.