Create Template Folder

Create a new template folder in your workspace

Published

POST
/v1/studio/folders
curl -X POST "https://api.orshot.com/v1/studio/folders" \
  -H "Authorization: Bearer <ORSHOT_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "<NAME>"
  }'

Overview#

Create a folder to organize your studio templates. Folders are a paid plan feature, same as in the dashboard.

Creator plan and above rate limit: 30 requests/min per API key
Endpoint
https://api.orshot.com/v1/studio/folders

Request Body#

nameStringrequired

Folder name, up to 50 characters, unique per workspace

Request#

JavaScript
await fetch("https://api.orshot.com/v1/studio/folders", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    name: "Social Posts",
  }),
});
JSON
{
  "folder": {
    "id": 11,
    "name": "Social Posts",
    "sort_order": 0,
    "created_at": "2026-07-11T08:04:37.768124+00:00"
  }
}

Returns 201 Created on success.

Error Responses#

JSON
{
  "error": "Template folders require a paid plan",
  "code": "folders_paid_plan_required"
}

Duplicate Name (409)#

JSON
{
  "error": "A folder with this name already exists"
}

Invalid Name (400)#

JSON
{
  "error": "Folder name cannot be empty"
}

Rate Limits#

  • 30 requests per minute per API key
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 50+ integrations
  • White-label embed for your own app
  • 30 free credits — no credit card required