Templates

Create Template

Create a template from a Canva URL.

This endpoint processes a Canva URL and extracts template information including layers, dimensions, and other metadata.

post/v1/template

Request

  • Base URL: https://layerre.com (the document declares no server; this is the origin it was published from)
  • URL: https://layerre.com/v1/template
  • Auth: HTTP bearer

Request body

canva_urlstring required

Canva share URL

tagsstring[] nullable

Initial tags for the template.

Example request

{
  "canva_url": "https://www.canva.com/design/...",
  "tags": [
    "campaign",
    "summer-2026"
  ]
}

Response

Template created successfully

idstring uuid required
namestring required

Template name

widthinteger required

Template width in pixels

heightinteger required

Template height in pixels

source_urlstring required

Original Canva URL

background_colorstring required

Background color of the first page (page 0) in hex format

page_backgroundsobject

Per-page background colors keyed by page index as a string. Page 0 is also available in background_color.

preview_urlstring nullable

Preview image URL

tagsstring[]

User-defined tags for organizing designs into folders

created_atstring date-time required
updated_atstring date-time required
warningsstring[] nullable
page_countinteger

Number of pages in this template (derived from layers)

variant_countinteger nullable

Number of variants for this template (only included in list endpoint)

Example response

{
  "name": "My Template",
  "width": 800,
  "height": 600,
  "source_url": "https://www.canva.com/design/...",
  "background_color": "#FFFFFF",
  "page_backgrounds": {
    "0": "#000000",
    "1": "#FFFFFF",
    "9": "#000000"
  },
  "preview_url": "https://example.com/preview.png",
  "layers": [
    {
      "name": "Title Layer",
      "properties": {
        "width": 100,
        "height": 100,
        "color": "#FF0000",
        "text": "Hello World",
        "font_size": 16,
        "font_name": "Arial",
        "text_direction": "rtl",
        "line_spacing": 1000,
        "vertical_align": "middle",
        "img_url": "https://example.com/image.png",
        "opacity": 1
      }
    }
  ],
  "tags": [
    "campaign",
    "summer-2026"
  ]
}

Changes

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