# Swaglists developer documentation > Guides and reference for the Swaglists API: create print-on-demand products and orders that we manufacture and ship under your brand. Base URL https://swaglists.com/api/v1. Machine-readable index: https://swaglists.com/llms.txt · everything in one file: https://swaglists.com/llms-full.txt · OpenAPI: https://swaglists.com/api/v1/openapi.json ## Getting started - [Introduction](https://swaglists.com/docs/introduction.md): What you can build with the Swaglists API and how an order flows from your store to your customer's door. - [Quickstart](https://swaglists.com/docs/quickstart.md): Go from zero to a shipped test order in about five minutes — catalog, artwork, product, order, simulated production and a signed webhook. - [Authentication & API keys](https://swaglists.com/docs/authentication.md): Secret API keys, test vs live mode, scopes, rotation, expiry and IP allowlists. - [Test mode](https://swaglists.com/docs/test-mode.md): Build and test your whole integration for free — test keys, test credits, simulated production, lifecycle controls and magic values. - [Going live checklist](https://swaglists.com/docs/going-live.md): Everything to check before you switch from test keys to live keys and send real orders. ## Core concepts - [Catalog & placements](https://swaglists.com/docs/catalog.md): Catalog products, variants and options, placements (print areas), recommended artwork sizes, DPI and file requirements. - [Designs & transforms](https://swaglists.com/docs/designs.md): How artwork is placed on a print area — layers, the position (transform) model with a worked example, defaults and resolution checks. - [Products & SKUs](https://swaglists.com/docs/products.md): Create products from catalog products and your designs, give variants your own SKUs, map them to your store and export them to Shopify or WooCommerce. - [Orders](https://swaglists.com/docs/orders.md): Create, confirm, change and cancel orders; the order lifecycle, statuses, hold reasons, item statuses and how credits move. - [Shipping & tracking](https://swaglists.com/docs/shipping.md): Shipping methods and rates, delivery estimates, shipments and tracking, the branded tracking page and customer shipment emails. - [Credits & billing](https://swaglists.com/docs/billing.md): The prepaid credit wallet — available vs held credits, bonus tiers, top-ups, auto-recharge, what happens without enough credits, and refunds. - [Pricing](https://swaglists.com/docs/pricing.md): Your wholesale prices, what an order costs (items, extra placements, shipping, tax), and the guarantee that an estimate equals the charge. ## Guides - [Personalized orders](https://swaglists.com/docs/personalized-orders.md): Send different artwork with every order — names, photos or generated designs — by URL or uploaded file, without creating a product first. - [Webhooks](https://swaglists.com/docs/webhooks.md): Get notified when orders are produced, shipped and delivered — endpoints, events, the payload, signature verification (libraries and manual HMAC), retries, replays and best practices. - [Idempotency](https://swaglists.com/docs/idempotency.md): Retry requests safely with Idempotency-Key, and make order forwarding duplicate-proof with external_id. - [Pagination](https://swaglists.com/docs/pagination.md): Cursor pagination for list endpoints — limit, starting_after, ending_before and has_more. - [Errors](https://swaglists.com/docs/error-handling.md): The error object, error types and HTTP statuses, which errors to retry, and how to debug with request ids. - [Rate limits](https://swaglists.com/docs/rate-limits.md): Per-key request limits, the RateLimit headers on every response, and how to back off from 429s. - [Versioning](https://swaglists.com/docs/versioning.md): How the API is versioned, what counts as a backwards-compatible change, and how to build an integration that keeps working. ## Integrations - [Shopify](https://swaglists.com/docs/shopify.md): Forward paid Shopify orders automatically — orders/paid webhook, HMAC verification, SKU mapping, POST /orders — and push tracking back to Shopify. - [WooCommerce](https://swaglists.com/docs/woocommerce.md): Forward WooCommerce orders when they are paid — a drop-in PHP plugin on woocommerce_order_status_processing, or a REST webhook to your own service — and push tracking back. - [BigCommerce](https://swaglists.com/docs/bigcommerce.md): Forward BigCommerce orders when they reach Awaiting Fulfillment — status webhook, fetch the order, one production order per shipping address — and create shipments with tracking. - [Custom checkout](https://swaglists.com/docs/custom-checkout.md): Integrate any store or app — quote shipping at checkout, create the order after payment, and keep your order status and tracking in sync with webhooks. - [No-code (Zapier, Make)](https://swaglists.com/docs/no-code.md): Connect any app without writing a server — send orders with an HTTP request step in Zapier or Make, and react to order updates safely. - [Product catalog export & import](https://swaglists.com/docs/catalog-export.md): Export your products as Shopify or WooCommerce CSV files, import them into your store, keep SKUs in sync, and bulk-create products from a spreadsheet with the API. ## Reference - [API reference](https://swaglists.com/docs/api-reference.md): Every endpoint of the REST API with parameters, request and response fields, error codes and examples — generated from the OpenAPI document. - [Error codes](https://swaglists.com/docs/errors.md): Every error code the API returns — what it means, how to fix it and whether to retry. - [Events reference](https://swaglists.com/docs/events.md): Every event type, when it fires, what data.object contains, and a complete example payload for each. - [Objects reference](https://swaglists.com/docs/objects.md): Every object the API returns — fields, types and descriptions, generated from the API schema. - [Changelog](https://swaglists.com/docs/changelog.md): Changes to the API and the developer documentation, newest first. - [FAQ](https://swaglists.com/docs/faq.md): Short answers to the questions developers ask most.