Skip to main content
POST
Create a design

Authorizations

Authorization
string
header
required

A secret key from Print.App admin → Domains → Secret keys, sent as Authorization: Bearer sk_…. Server-side only.

Headers

Idempotency-Key
string

Makes a retry safe: a second request with the same key and the same body gets the first response back (for 24 hours) instead of creating the resource again. Use a new key, such as a UUID, for every new request.

Required string length: 1 - 255

Body

application/json

A new design with blank pages.

width
number
required

Trim width.

height
number
required

Trim height.

title
string

The design's name. Default New design.

Required string length: 1 - 200
unit
enum<string>
default:in

The unit for width, height, bleed and safeMargin, and the unit the design is measured in afterwards.

Available options:
in,
mm,
cm,
pt,
px,
ft
pages
integer
default:1

How many pages.

Required range: 1 <= x <= 200
pageTitles
string[]

A title per page, for example ["Front", "Back"]. Default Page 1, Page 2, …

Maximum array length: 200
Maximum string length: 100
bleed
number
default:0

Bleed on every edge, outside the trim.

Required range: x >= 0
safeMargin
number
default:0

Safe margin on every edge, inside the trim.

Required range: x >= 0
folderId
string

The design folder to create it in. Default root, the top level.

Required string length: 1 - 200
tags
string[]

Labels for finding it again.

Maximum array length: 50
Required string length: 1 - 50

Response

Created.

A design (template) your customers start from. Open it in the editor with new PrintAppClient({ designId }).

object
string
required
Allowed value: "design"
id
string
required

The designId to pass to PrintAppClient.

title
string | null
required
unit
string | null
required

The unit the design is measured in: mm, cm, in, pt, px or ft.

pages
object[]
required
tags
string[]
required
created
string<date-time> | null
required
modified
string<date-time> | null
required