Skip to main content
POST
Create an editor link

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

What the link opens. Send one of designId or projectId.

designId
string
required

A design to start from.

Required string length: 1 - 200
projectId
string

A project to carry on with.

Required string length: 1 - 200
expiresAt
string<date-time>

When the link stops working. Default: 30 days from now. At most a year.

userData
object

Your own details (customer, order), saved onto projects made through the link.

Response

Created.

An editor link at create.print.app.

object
string
required
Allowed value: "link"
id
string
required
url
string
required

Send this to your customer.

designId
string | null
required
projectId
string | null
required

The project it opens, or the one a customer saved through it.

userData
object | null
required
expiresAt
string<date-time> | null
required
created
string<date-time> | null
required