Create a print order

Validates PDF + address BEFORE minting any payment link. payment_link keys/anonymous: response carries payment_url. invoiced keys: order auto-confirms. Save order_token — shown once.

post/v1/orders

Request

  • Base URL: https://themassprint.com
  • URL: https://themassprint.com/v1/orders
  • Auth: one of:
    • HTTP bearer
    • none

Request body

upload_idstring required
skustring

Optional; inferred from format (sticker-a3 → sticker-a3, greeting-card-a5 → greeting-card-a5, else storybook).

format'paperback' | 'hardcover' | 'sticker-a3' | 'greeting-card-a5' required

paperback/hardcover: bound storybook. sticker-a3: single-sheet A3 portrait sticker / wall chart (exactly 1 page, 842×1191 pt). greeting-card-a5: folded A5 greeting card, one A4-landscape sheet printed duplex (exactly 2 pages, 859×612 pt incl. 3 mm bleed).

copiesinteger
emailstring email required
client_referencestring

Caller-owned idempotency key (e.g. your own order id). API-keyed callers replaying the same reference get HTTP 200 with the ORIGINAL order and deduplicated: true — never a second print. A canceled/refunded/expired order releases its reference. Anonymous callers may send it but only keyed callers get the dedupe guarantee.

Response

Replayed client_reference: the original order is returned, no new order is created. order_token is null — it was shown once, at the original creation.

order_tokenunknown
deduplicatedtrue

Changes

No recorded changes to this operation across all 1 revision of this API.