Create Studio Template

// Create a blank template with specified dimensions
await fetch("https://api.orshot.com/v1/studio/templates/create", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    name: "Product Banner",
    description: "E-commerce product showcase banner",
    canvas_width: 1200,
    canvas_height: 628,
    embed_user_id: "your-external-user-id" // Optional
  }),
});

// Create a template with pre-built page structure
await fetch("https://api.orshot.com/v1/studio/templates/create", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    name: "Social Media Post",
    description: "Instagram post template",
    canvas_width: 1080,
    canvas_height: 1080,
    pages_data: [
      {
        id: "page-1-uuid",
        name: "Page 1",
        canvas: {
          width: 1080,
          height: 1080,
          backgroundColor: "#ffffff"
        },
        elements: [
          {
            id: "headline-element",
            type: "text",
            position: { x: 100, y: 200 },
            dimensions: { width: 880, height: 100 },
            content: "Your Headline Here",
            parameterId: "headline",
            parameterizable: true
          },
          {
            id: "image-element",
            type: "image",
            position: { x: 100, y: 350 },
            dimensions: { width: 880, height: 500 },
            content: "https://example.com/placeholder.png",
            parameterId: "product_image",
            parameterizable: true
          }
        ],
        modifications: []
      }
    ]
  }),
});

{
  "success": true,
  "template": {
    "id": 12345,
    "name": "Product Banner",
    "canvas_width": 1200,
    "canvas_height": 628,
    "tags": [],
    "pages_count": 1,
    "modifications": [
      {
        "key": "headline",
        "id": "headline",
        "type": "text",
        "description": "Headline — Text content",
        "help_text": "Headline — Text content",
        "element_name": "Headline",
        "example": "Your Headline Here",
        "page_number": 1,
        "page_id": "page-1-uuid"
      },
      {
        "key": "product_image",
        "id": "product_image",
        "type": "imageUrl",
        "description": "Product Image — Image URL",
        "help_text": "Product Image — Image URL",
        "element_name": "Product Image",
        "example": "https://example.com/placeholder.png",
        "page_number": 1,
        "page_id": "page-1-uuid"
      }
    ],
    "created_at": "2026-01-29T10:30:00.000Z"
  }
}

{
  "success": true,
  "template": {
    "id": 12345,
    "name": "Product Banner",
    "canvas_width": 1200,
    "canvas_height": 628,
    "tags": [],
    "pages_count": 1,
    "modifications": [
      {
        "key": "headline",
        "id": "headline",
        "type": "text",
        "description": "Headline — Text content",
        "help_text": "Headline — Text content",
        "element_name": "Headline",
        "example": "Your Headline Here",
        "page_number": 1,
        "page_id": "page-1-uuid"
      }
    ],
    "created_at": "2026-01-29T10:30:00.000Z",
    "thumbnails": {
      "success": true,
      "pages": [
        {
          "page": 1,
          "page_id": "page-1-uuid",
          "thumbnail_url": "https://storage.orshot.com/cloud/w-50/renders/thumbnails/abc123.png",
          "error": null
        }
      ]
    }
  }
}