The Canva Apps SDK, Connect APIs, and MCP are now unified in the Canva Developers SDK. Learn more⁠(opens in a new tab or window).
Canva Developers SDK
The Canva Apps SDK, Connect APIs, and MCP are now unified in the Canva Developers SDK. Learn more⁠(opens in a new tab or window).

create-brand-template-draft

Create an editable draft design from a brand template.

To use this tool, the user must be on a Canva plan with access to brand templates (such as Canva Pro, Canva Teams, or Canva Enterprise).

Use create-brand-template-draft to get a design that you can edit and then publish back as the updated brand template. If a draft already exists for the brand template, the tool returns the existing draft.

To update a brand template:

  1. Call create-brand-template-draft with the brand template's ID.
  2. Edit the returned design with edit-design.
  3. Publish the edited design as the brand template with publish-brand-template.

Example prompt

"Update our brand template for event flyers with the new logo."

Pass the brand_template_id. To find brand templates and their IDs, use search-brand-templates.

Example response

IDs, URLs, and tokens below are placeholders; field names and structure are exactly as returned.

{
"design": {
"id": "DAF_EXAMPLE",
"title": "Event Flyer Template",
"owner": { "user_id": "USER_EXAMPLE", "team_id": "TEAM_EXAMPLE" },
"thumbnail": { "width": 595, "height": 842, "url": "https://document-export.canva.com/EXAMPLE_THUMBNAIL" },
"urls": { "edit_url": "https://www.canva.com/d/EXAMPLE_EDIT", "view_url": "https://www.canva.com/d/EXAMPLE_VIEW" },
"created_at": 1784078449,
"updated_at": 1784078449,
"page_count": 1
}
}
JSON

Returns the draft design with its id, edit_url, and view_url. Use the id to edit the draft, and later to publish it. The thumbnail is generated asynchronously, so it might not be present in the response.

This tool requires the brandtemplate:content:write scope. If the call fails with Missing scopes: [brandtemplate:content:write], the user needs to disconnect and reconnect Canva in your AI application to grant the scope.

Learn more