Bulk Create Studio Templates

Create up to 50 studio templates in one JSON request

Updated Oct 27, 2026

POST

/v1/studio/templates/bulk-create

curl -X POST "https://api.orshot.com/v1/studio/templates/bulk-create" \
  -H "Authorization: Bearer <ORSHOT_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "templates": []
  }'

const res = await fetch("https://api.orshot.com/v1/studio/templates/bulk-create", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    "templates": []
  }),
});

const data = await res.json();

import requests

response = requests.post(
    "https://api.orshot.com/v1/studio/templates/bulk-create",
    headers={"Authorization": "Bearer <ORSHOT_API_KEY>"},
    json={
      "templates": []
    },
)

data = response.json()

$ch = curl_init("https://api.orshot.com/v1/studio/templates/bulk-create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <ORSHOT_API_KEY>",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
  "templates" => []
]));

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

require "net/http"
require "json"

uri = URI("https://api.orshot.com/v1/studio/templates/bulk-create")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer <ORSHOT_API_KEY>"
req["Content-Type"] = "application/json"
req.body = {
  "templates": []
}.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)

Enterprise Only

This endpoint is available only to first party clients like the Orshot MCP server and workspaces on the Enterprise plan. Check out Enterprise pricing to get access.

Create multiple studio templates in a single API call. This endpoint is ideal for importing templates in bulk from external systems or migrating existing template libraries.

For detailed information about the template data structure, see Anatomy of a Template.

Endpoint#

Endpoint

https://api.orshot.com/v1/studio/templates/bulk-create

Query Parameters#

Parameter	Type	Required	Default	Description
`includeThumbnails`	Boolean	No	`false`	When `true`, thumbnails for every page of every template are rendered before the response is sent. Templates are processed sequentially to bound concurrency; expect ~1–2 seconds per page. When `false` or absent, thumbnails are generated in the background.

Request#

JavaScript

await fetch("https://api.orshot.com/v1/studio/templates/bulk-create", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    templates: [
      {
        name: "Instagram Post - Square",
        description: "1:1 aspect ratio for Instagram feed",
        canvas_width: 1080,
        canvas_height: 1080
      },
      {
        name: "Instagram Story",
        description: "9:16 aspect ratio for Instagram stories",
        canvas_width: 1080,
        canvas_height: 1920
      },
      {
        name: "Facebook Cover",
        description: "Facebook page cover photo",
        canvas_width: 820,
        canvas_height: 312
      },
      {
        name: "Twitter Header",
        description: "Twitter profile header image",
        canvas_width: 1500,
        canvas_height: 500
      },
      {
        name: "LinkedIn Banner",
        description: "LinkedIn company page banner",
        canvas_width: 1128,
        canvas_height: 191
      }
    ]
  }),
});

JSON

{
  "success": true,
  "created": 5,
  "failed": 0,
  "templates": [
    {
      "id": 12345,
      "name": "Instagram Post - Square",
      "canvas_width": 1080,
      "canvas_height": 1080
    },
    {
      "id": 12346,
      "name": "Instagram Story",
      "canvas_width": 1080,
      "canvas_height": 1920
    },
    {
      "id": 12347,
      "name": "Facebook Cover",
      "canvas_width": 820,
      "canvas_height": 312
    },
    {
      "id": 12348,
      "name": "Twitter Header",
      "canvas_width": 1500,
      "canvas_height": 500
    },
    {
      "id": 12349,
      "name": "LinkedIn Banner",
      "canvas_width": 1128,
      "canvas_height": 191
    }
  ]
}

JSON

{
  "success": true,
  "created": 2,
  "failed": 0,
  "templates": [
    {
      "id": 12345,
      "name": "Instagram Post - Square",
      "canvas_width": 1080,
      "canvas_height": 1080,
      "thumbnails": {
        "success": true,
        "pages": [
          {
            "page": 1,
            "page_id": "page-1",
            "thumbnail_url": "https://storage.orshot.com/cloud/w-50/renders/thumbnails/a1b2c3.png",
            "error": null
          }
        ]
      }
    },
    {
      "id": 12346,
      "name": "Instagram Story",
      "canvas_width": 1080,
      "canvas_height": 1920,
      "thumbnails": {
        "success": true,
        "pages": [
          {
            "page": 1,
            "page_id": "page-2-uuid",
            "thumbnail_url": "https://storage.orshot.com/cloud/w-50/renders/thumbnails/d4e5f6.png",
            "error": null
          }
        ]
      }
    }
  ]
}

JSON

{
  "success": true,
  "created": 3,
  "failed": 2,
  "templates": [
    {
      "id": 12345,
      "name": "Valid Template 1",
      "canvas_width": 1080,
      "canvas_height": 1080
    },
    {
      "id": 12346,
      "name": "Valid Template 2",
      "canvas_width": 1200,
      "canvas_height": 628
    },
    {
      "id": 12347,
      "name": "Valid Template 3",
      "canvas_width": 800,
      "canvas_height": 600
    }
  ],
  "errors": [
    {
      "index": 3,
      "name": "Invalid Template",
      "errors": ["'canvas_width' must be between 1 and 5000"]
    },
    {
      "index": 4,
      "name": "Template 5",
      "errors": ["'name' is required and must be a string"]
    }
  ]
}

Rate Limits#

Limit	Value
Requests per minute	30
Max templates per request	50

The limit is 30 requests per minute per API key, shared by every /v1/studio template endpoint, including template reads. Renders are not counted.

Request Body Parameters#

Parameter	Type	Required	Description
`templates`	Array	Yes	Array of template objects to create

Template Object Structure#

Each template in the templates array should include:

Field	Type	Required	Description
`name`	String	Yes	Name of the template (max 255 characters)
`description`	String	No	Description of the template
`canvas_width`	Integer	Yes	Width of the canvas in pixels (1-5000)
`canvas_height`	Integer	Yes	Height of the canvas in pixels (1-5000)
`pages_data`	Array	No	Array of page objects with elements
`tags`	Array	No	Array of tag strings, e.g. `["social", "marketing"]`
`film`	Object	No	Makes the template a film, same as in Create Studio Template
`thumbnail_url`	String	No	Ignored. Orshot renders a thumbnail for each page from your design

Pages may include audio tracks, generated narration, ambient audio, subtitles, waveform elements, and a saved video duration. Generated narration and ambient audio are resolved for each template as it is created. See Template Anatomy for the complete schema.

Response Fields#

Field	Type	Description
`success`	Boolean	Whether the operation completed (may be partial success)
`created`	Integer	Number of templates successfully created
`failed`	Integer	Number of templates that failed validation
`templates`	Array	Created templates. Each item has `id`, `name`, `canvas_width`, `canvas_height` and `tags`
`errors`	Array	Array of error objects for failed templates (only if any failed)

Error Object Structure#

Field	Type	Description
`index`	Integer	Index of the failed template in the original array
`name`	String	Name of the template that failed, or `Template <n>` (1-based) when it had no name
`errors`	Array	List of error messages (validation, stock media or narration)

Thumbnails Object Structure#

When you pass ?includeThumbnails=true, each entry in templates[] gets a nested thumbnails object with per-page render results:

Field	Type	Description
`success`	Boolean	`true` if at least one page of this template rendered successfully
`pages[].page`	Integer	1-based page number
`pages[].page_id`	String	Stable id of the page
`pages[].thumbnail_url`	String\|null	Public URL of the uploaded thumbnail PNG. `null` if this page failed
`pages[].error`	String\|null	Error message if this page failed. `null` on success

When ?includeThumbnails is not passed, thumbnails are generated asynchronously after the response is sent and appear on each page's thumbnail_url in Get Studio Template shortly after creation.

Bulk Import with Pages Data#

You can also include full page structures with elements for each template:

JavaScript

await fetch("https://api.orshot.com/v1/studio/templates/bulk-create", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    templates: [
      {
        name: "Product Card A",
        canvas_width: 800,
        canvas_height: 600,
        pages_data: [
          {
            id: "page-uuid-1",
            name: "Page 1",
            canvas: { width: 800, height: 600, backgroundColor: "#f5f5f5" },
            elements: [
              {
                id: "title-1",
                type: "text",
                position: { x: 50, y: 50 },
                dimensions: { width: 700, height: 60 },
                content: "Product Title",
                parameterId: "title",
                parameterizable: true,
              },
            ],
          },
        ],
      },
      {
        name: "Product Card B",
        canvas_width: 800,
        canvas_height: 600,
        pages_data: [
          {
            id: "page-uuid-2",
            name: "Page 1",
            canvas: { width: 800, height: 600, backgroundColor: "#ffffff" },
            elements: [
              {
                id: "title-2",
                type: "text",
                position: { x: 50, y: 50 },
                dimensions: { width: 700, height: 60 },
                content: "Product Title",
                parameterId: "title",
                parameterizable: true,
              },
            ],
          },
        ],
      },
    ],
  }),
});

Error Responses#

Status Code	Error	Description
400	Validation failed	`templates` array is missing, empty, or exceeds 50 items
400	All templates failed validation	Every template in the array had validation errors
401	Unauthorized	The OAuth token is invalid or expired. Refresh it
403	Access Forbidden	Invalid or missing API key, your plan does not include this endpoint, or a payment is overdue (see `code`)
429	Rate limit exceeded	Too many requests (max 30/min)
500	Internal server error	Server-side error

Best Practices#

Batch Size: While the limit is 50 templates per request, we recommend batches of 20-30 for optimal performance
Validation: Validate your data client-side before sending to avoid partial failures
Error Handling: Always check both created and failed counts in the response
Idempotency: This endpoint creates new templates each time - there's no upsert functionality
Pages Data: If importing templates with complex structures, ensure pages_data follows the Orshot Studio format

Was this page helpful?

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key

Image, PDF and video generation via API
Visual editor with AI and smart layouts
Zapier, Make, MCP and 40+ integrations
White-label embed for your own app
100 free credits a month, no credit card required