Create a builder template

POST https://api.craftkit.dev/v1/embed/builder/templates

Creates a template in the authenticated partner’s project from a builder draft. The draft is stored verbatim; if the caller has publish rights and the layout parses as a render-ready document, a first version is published automatically.

Authorization

Accepts either a partner API key or an embed session JWT.

string

required

Bearer ck_live_… (partner API key — grants saveDraft and publish) or Bearer <session_token> (embed session JWT — rights come from the session’s permissions claims, and the request must originate from an allow-listed iframe origin).

Body

object

required

The builder draft to persist. Stored as-is; the whole object is returned (adapted) in the response. Only name, layout, and presetKey are interpreted server-side — all other keys round-trip through the draft.

Show documentTemplate

string

default:"Untitled template"

Template display name. The slug is derived from it and suffixed with a short random token.

object

The builder’s internal canvas draft (react-email-dnd CanvasDocument). Not validated on create — publishing parses it and silently skips publish if it does not match the render-ready shape.

string | null

default:"null"

Template-type identifier (for example charter-handover).

Response

200 with the created template, adapted to the builder’s documentTemplate shape.

object

Show documentTemplate

string

New template UUID. Use it as templateExternalId when minting a fill session.

string

The owning project’s id.

string

boolean

Soft-delete flag; false for a new template.

string

ISO-8601 creation timestamp.

string | null

object | null

The persisted builder layout draft.

Errors

Status	code	Meaning
400	`invalid_json`	Body is not valid JSON.
401	`missing_or_invalid_authorization`	No bearer token, or neither a valid API key nor a valid session token.
403	`permission_denied`	Authenticated, but the session lacks `saveDraft` rights.
500	`insert_failed`	The template row could not be written.

cURL

curl -X POST https://api.craftkit.dev/v1/embed/builder/templates \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "documentTemplate": {
      "name": "Charter Handover",
      "presetKey": "charter-handover",
      "layout": { "sections": [] }
    }
  }'

200

{
  "documentTemplate": {
    "_id": "0193c2c3-...",
    "organizationId": "proj_01j...",
    "name": "Charter Handover",
    "sD": false,
    "cAt": "2026-06-05T10:00:00.000Z",
    "presetKey": "charter-handover",
    "isCustomTemplate": true,
    "layout": { "sections": [] },
    "design": null
  }
}

Projects

Templates

Renders

Signatures

Webhooks

Embed

Reference

Projects

Templates

Renders

Signatures

Webhooks

Embed

Admin

System

Create a builder template

Authorization

Body

Response

Errors

​Authorization

​Body

​Response

​Errors

Authorization

Body

Response

Errors