Join us now
← Back to API Reference overview

QR Code Templates

Endpoints for managing QR Code Templates in Linkbreakers. These endpoints allow you to create, retrieve, update, and delete QR Code Templates.

Shortcut: ⌘K

#The QR Code Template object

Provides the reusable presets Linkbreakers suggests when teams create new links, bundling a design and copy so campaigns start with on-brand defaults.

builtIn

boolean

Whether the template is maintained by Linkbreakers (available to every workspace)

createdAt

string (date-time)

When the template was created

description

string

Short marketing description displayed in the template picker

id

string

Unique identifier of the template (UUID)

name

string

Human-readable name shown in the gallery

priority

integer (int32)

Ordering weight used when recommending templates (higher = more relevant)

qrcodeDesign

object

Captures the visual recipe Linkbreakers uses when rendering downloadable QR codes, including colors, shapes, export options, and center media. QR Code Designs are the visual representation of a link. They can be attached to QR Code Templates for reusability. They can only be attached to one record at a time.

qrcodeDesignId

string

Backing QR code design that determines styling defaults (UUID)

slug

string

Slug used in public template selection URLs

thumbnailSignedUrl

string

Signed thumbnail preview of the template design

updatedAt

string (date-time)

When the template metadata was last updated

workspaceId

string

Workspace that owns the template; empty for built-in templates (UUID when present)

GET/v1/qrcode-templatesRequires auth

#List QR code templates

Retrieve available QR code templates, optionally filtered by search terms or link destination.

#Parameters

query parameters

search

stringquery

Search query applied to template name/description

pageSize

integer (int32)query

Maximum number of templates to return (defaults to 20)

linkDestination

stringquery

Optional link destination to personalize recommendations

include

array<string>query

pageToken

stringquery

Cursor token to retrieve the next page of results

#Response

200

Everything worked as expected.

bestFitId

string

The design template that fits best the user's needs This is resolved from the linkDestination if given Returns the template ID to auto-select on the client (UUID)

hasMore

boolean

Whether another page exists after this result set

nextPageToken

string

Cursor token returned when another page is available

qrcodeTemplates

array<object>

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.