Skip navigation

Skip to main content

Autofill
Autofill

Create design autofill job

Create an asynchronous job to autofill a design from a brand template with your input information.

Soon, all brand template IDs will be updated to a new format. If your integration stores brand template IDs, you'll need to migrate to use the new IDs. After we implement this change, you'll have 6 months to migrate before the old IDs are removed.

To use this API, your integration must act on behalf of a user that's a member of a Canva Enterprise⁠(opens in a new tab or window) organization.

Starts a new asynchronous job to autofill a Canva design using a brand template and input data.

To get a list of input data fields, use the Get brand template dataset API.

Available data field types to autofill include:

  • Images

  • Text

  • Charts

    Chart data fields are a preview feature. There might be unannounced breaking changes to this feature which won't produce a new API version.

For more information on the workflow for using asynchronous jobs, see API requests and responses. You can check the status and get the results of autofill jobs created with this API using the Get design autofill job API.

HTTP method and URL path

POST https://api.canva.com/rest/v1/autofills

This operation is rate limited to 10 requests per minute for each user of your integration.

Authentication and authorization

This endpoint requires a valid access token that acts on behalf of a user.

Scopes

The access token must have all the following scopes (permissions):

  • design:content:write

Header parameters

Authorizationstring
Required

Provides credentials to authenticate the request, in the form of a Bearer token.

For example: Authorization: Bearer {token}

Content-Typestring
Required

Indicates the media type of the information sent in the request. This must be set to application/json.

For example: Content-Type: application/json

Body parameters

brand_template_idstring
Required

ID of the input brand template.

dataobject
Required

Data object containing the data fields and values to autofill.

<KEY>object of DatasetValues
Required

The data field to autofill.

{
  "cute_pet_image_of_the_day": {
    "type": "image",
    "asset_id": "Msd59349ff"
  },
  "cute_pet_witty_pet_says": {
    "type": "text",
    "text": "It was like this when I got here!"
  },
  "cute_pet_sales_chart": {
    "type": "chart",
    "chart_data": {
      "rows": [
        {
          "cells": [
            {
              "type": "string",
              "value": "Geographic Region"
            },
            {
              "type": "string",
              "value": "Sales (millions AUD)"
            },
            {
              "type": "string",
              "value": "Target met?"
            },
            {
              "type": "string",
              "value": "Date met"
            }
          ]
        },
        {
          "cells": [
            {
              "type": "string",
              "value": "Asia Pacific"
            },
            {
              "type": "number",
              "value": 10.2
            },
            {
              "type": "boolean",
              "value": true
            },
            {
              "type": "date",
              "value": 1721944387
            }
          ]
        },
        {
          "cells": [
            {
              "type": "string",
              "value": "EMEA"
            },
            {
              "type": "number",
              "value": 13.8
            },
            {
              "type": "boolean",
              "value": false
            },
            {
              "type": "date"
            }
          ]
        }
      ]
    }
  }
}
JSON

If the data field is an image field.

typestring
Required

Available values: The only valid value is image.

asset_idstring
Required

asset_id of the image to insert into the template element.

If the data field is a text field.

typestring
Required

Available values: The only valid value is text.

textstring
Required

Text to insert into the template element.

If the data field is a chart.

Chart data fields are a preview feature. There might be unannounced breaking changes to this feature which won't produce a new API version.

typestring
Required

Available values: The only valid value is chart.

chart_dataDataTable
Required

Tabular data, structured in rows of cells.

  • The first row usually contains column headers.
  • Each cell must have a data type configured.
  • All rows must have the same number of cells.
  • Maximum of 100 rows and 20 columns.

Chart data fields are a preview feature. There might be unannounced breaking changes to this feature which won't produce a new API version.

rowsDataTableRow[]
Required

Rows of data.

The first row usually contains column headers.

Maximum items: 100

cellsDataTableCell[]
Required

Cells of data in row.

All rows must have the same number of cells.

Maximum items: 20

A string tabular data cell.

typestring
Required

Available values: The only valid value is string.

valuestring
Optional

A number tabular data cell.

typestring
Required

Available values: The only valid value is number.

valuenumber
Optional

A boolean tabular data cell.

typestring
Required

Available values: The only valid value is boolean.

valueboolean
Optional

A date tabular data cell.

Specified as a Unix timestamp (in seconds since the Unix Epoch).

typestring
Required

Available values: The only valid value is date.

valueinteger
Optional
titlestring
Optional

Title to use for the autofilled design.

If no design title is provided, the autofilled design will have the same title as the brand template.

Minimum length: 1

Maximum length: 255

Example request

Examples for using the /v1/autofills endpoint:

curl --request POST 'https://api.canva.com/rest/v1/autofills' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{
  "brand_template_id": "DAFVztcvd9z",
  "title": "string",
  "data": {
    "cute_pet_image_of_the_day": {
      "type": "image",
      "asset_id": "Msd59349ff"
    },
    "cute_pet_witty_pet_says": {
      "type": "text",
      "text": "It was like this when I got here!"
    },
    "cute_pet_sales_chart": {
      "type": "chart",
      "chart_data": {
        "rows": [
          {
            "cells": [
              {
                "type": "string",
                "value": "Geographic Region"
              },
              {
                "type": "string",
                "value": "Sales (millions AUD)"
              },
              {
                "type": "string",
                "value": "Target met?"
              },
              {
                "type": "string",
                "value": "Date met"
              }
            ]
          },
          {
            "cells": [
              {
                "type": "string",
                "value": "Asia Pacific"
              },
              {
                "type": "number",
                "value": 10.2
              },
              {
                "type": "boolean",
                "value": true
              },
              {
                "type": "date",
                "value": 1721944387
              }
            ]
          },
          {
            "cells": [
              {
                "type": "string",
                "value": "EMEA"
              },
              {
                "type": "number",
                "value": 13.8
              },
              {
                "type": "boolean",
                "value": false
              },
              {
                "type": "date"
              }
            ]
          }
        ]
      }
    }
  }
}'
SH
const fetch = require("node-fetch");


fetch("https://api.canva.com/rest/v1/autofills", {
  method: "POST",
  headers: {
    "Authorization": "Bearer {token}",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "brand_template_id": "DAFVztcvd9z",
    "title": "string",
    "data": {
      "cute_pet_image_of_the_day": {
        "type": "image",
        "asset_id": "Msd59349ff"
      },
      "cute_pet_witty_pet_says": {
        "type": "text",
        "text": "It was like this when I got here!"
      },
      "cute_pet_sales_chart": {
        "type": "chart",
        "chart_data": {
          "rows": [
            {
              "cells": [
                {
                  "type": "string",
                  "value": "Geographic Region"
                },
                {
                  "type": "string",
                  "value": "Sales (millions AUD)"
                },
                {
                  "type": "string",
                  "value": "Target met?"
                },
                {
                  "type": "string",
                  "value": "Date met"
                }
              ]
            },
            {
              "cells": [
                {
                  "type": "string",
                  "value": "Asia Pacific"
                },
                {
                  "type": "number",
                  "value": 10.2
                },
                {
                  "type": "boolean",
                  "value": true
                },
                {
                  "type": "date",
                  "value": 1721944387
                }
              ]
            },
            {
              "cells": [
                {
                  "type": "string",
                  "value": "EMEA"
                },
                {
                  "type": "number",
                  "value": 13.8
                },
                {
                  "type": "boolean",
                  "value": false
                },
                {
                  "type": "date"
                }
              ]
            }
          ]
        }
      }
    }
  }),
})
  .then(async (response) => {
    const data = await response.json();
    console.log(data);
  })
  .catch(err => console.error(err));
JS
import java.io.IOException;
import java.net.URI;
import java.net.http.*;


public class ApiExample {
    public static void main(String[] args) throws IOException, InterruptedException {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.canva.com/rest/v1/autofills"))
            .header("Authorization", "Bearer {token}")
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("{\"brand_template_id\": \"DAFVztcvd9z\", \"title\": \"string\", \"data\": {\"cute_pet_image_of_the_day\": {\"type\": \"image\", \"asset_id\": \"Msd59349ff\"}, \"cute_pet_witty_pet_says\": {\"type\": \"text\", \"text\": \"It was like this when I got here!\"}, \"cute_pet_sales_chart\": {\"type\": \"chart\", \"chart_data\": {\"rows\": [{\"cells\": [{\"type\": \"string\", \"value\": \"Geographic Region\"}, {\"type\": \"string\", \"value\": \"Sales (millions AUD)\"}, {\"type\": \"string\", \"value\": \"Target met?\"}, {\"type\": \"string\", \"value\": \"Date met\"}]}, {\"cells\": [{\"type\": \"string\", \"value\": \"Asia Pacific\"}, {\"type\": \"number\", \"value\": 10.2}, {\"type\": \"boolean\", \"value\": true}, {\"type\": \"date\", \"value\": 1721944387}]}, {\"cells\": [{\"type\": \"string\", \"value\": \"EMEA\"}, {\"type\": \"number\", \"value\": 13.8}, {\"type\": \"boolean\", \"value\": false}, {\"type\": \"date\"}]}]}}}}"))
            .build();


        HttpResponse<String> response = HttpClient.newHttpClient().send(
            request,
            HttpResponse.BodyHandlers.ofString()
        );
        System.out.println(response.body());
    }
}
JAVA
import requests


headers = {
    "Authorization": "Bearer {token}",
    "Content-Type": "application/json"
}


data = {
    "brand_template_id": "DAFVztcvd9z",
    "title": "string",
    "data": {
        "cute_pet_image_of_the_day": {
            "type": "image",
            "asset_id": "Msd59349ff"
        },
        "cute_pet_witty_pet_says": {
            "type": "text",
            "text": "It was like this when I got here!"
        },
        "cute_pet_sales_chart": {
            "type": "chart",
            "chart_data": {
                "rows": [
                    {
                        "cells": [
                            {
                                "type": "string",
                                "value": "Geographic Region"
                            },
                            {
                                "type": "string",
                                "value": "Sales (millions AUD)"
                            },
                            {
                                "type": "string",
                                "value": "Target met?"
                            },
                            {
                                "type": "string",
                                "value": "Date met"
                            }
                        ]
                    },
                    {
                        "cells": [
                            {
                                "type": "string",
                                "value": "Asia Pacific"
                            },
                            {
                                "type": "number",
                                "value": 10.2
                            },
                            {
                                "type": "boolean",
                                "value": True
                            },
                            {
                                "type": "date",
                                "value": 1721944387
                            }
                        ]
                    },
                    {
                        "cells": [
                            {
                                "type": "string",
                                "value": "EMEA"
                            },
                            {
                                "type": "number",
                                "value": 13.8
                            },
                            {
                                "type": "boolean",
                                "value": False
                            },
                            {
                                "type": "date"
                            }
                        ]
                    }
                ]
            }
        }
    }
}


response = requests.post("https://api.canva.com/rest/v1/autofills",
    headers=headers,
    json=data
)
print(response.json())
PY
using System.Net.Http;


var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://api.canva.com/rest/v1/autofills"),
  Headers =
  {
    { "Authorization", "Bearer {token}" },
  },
  Content = new StringContent(
    "{\"brand_template_id\": \"DAFVztcvd9z\", \"title\": \"string\", \"data\": {\"cute_pet_image_of_the_day\": {\"type\": \"image\", \"asset_id\": \"Msd59349ff\"}, \"cute_pet_witty_pet_says\": {\"type\": \"text\", \"text\": \"It was like this when I got here!\"}, \"cute_pet_sales_chart\": {\"type\": \"chart\", \"chart_data\": {\"rows\": [{\"cells\": [{\"type\": \"string\", \"value\": \"Geographic Region\"}, {\"type\": \"string\", \"value\": \"Sales (millions AUD)\"}, {\"type\": \"string\", \"value\": \"Target met?\"}, {\"type\": \"string\", \"value\": \"Date met\"}]}, {\"cells\": [{\"type\": \"string\", \"value\": \"Asia Pacific\"}, {\"type\": \"number\", \"value\": 10.2}, {\"type\": \"boolean\", \"value\": true}, {\"type\": \"date\", \"value\": 1721944387}]}, {\"cells\": [{\"type\": \"string\", \"value\": \"EMEA\"}, {\"type\": \"number\", \"value\": 13.8}, {\"type\": \"boolean\", \"value\": false}, {\"type\": \"date\"}]}]}}}}",
    Encoding.UTF8,
    "application/json"
  ),
};


using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
};
CSHARP
package main


import (
	"fmt"
	"io"
	"net/http"
	"strings"
)


func main() {
	payload := strings.NewReader(`{
	  "brand_template_id": "DAFVztcvd9z",
	  "title": "string",
	  "data": {
	    "cute_pet_image_of_the_day": {
	      "type": "image",
	      "asset_id": "Msd59349ff"
	    },
	    "cute_pet_witty_pet_says": {
	      "type": "text",
	      "text": "It was like this when I got here!"
	    },
	    "cute_pet_sales_chart": {
	      "type": "chart",
	      "chart_data": {
	        "rows": [
	          {
	            "cells": [
	              {
	                "type": "string",
	                "value": "Geographic Region"
	              },
	              {
	                "type": "string",
	                "value": "Sales (millions AUD)"
	              },
	              {
	                "type": "string",
	                "value": "Target met?"
	              },
	              {
	                "type": "string",
	                "value": "Date met"
	              }
	            ]
	          },
	          {
	            "cells": [
	              {
	                "type": "string",
	                "value": "Asia Pacific"
	              },
	              {
	                "type": "number",
	                "value": 10.2
	              },
	              {
	                "type": "boolean",
	                "value": true
	              },
	              {
	                "type": "date",
	                "value": 1721944387
	              }
	            ]
	          },
	          {
	            "cells": [
	              {
	                "type": "string",
	                "value": "EMEA"
	              },
	              {
	                "type": "number",
	                "value": 13.8
	              },
	              {
	                "type": "boolean",
	                "value": false
	              },
	              {
	                "type": "date"
	              }
	            ]
	          }
	        ]
	      }
	    }
	  }
	}`)


	url := "https://api.canva.com/rest/v1/autofills"
	req, _ := http.NewRequest("POST", url, payload)
	req.Header.Add("Authorization", "Bearer {token}")
	req.Header.Add("Content-Type", "application/json")


	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}
GO
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.canva.com/rest/v1/autofills",
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer {token}',
    'Content-Type: application/json',
  ),
  CURLOPT_POSTFIELDS => json_encode([
    "brand_template_id" => "DAFVztcvd9z",
    "title" => "string",
    "data" => [
      "cute_pet_image_of_the_day" => [
        "type" => "image",
        "asset_id" => "Msd59349ff"
      ],
      "cute_pet_witty_pet_says" => [
        "type" => "text",
        "text" => "It was like this when I got here!"
      ],
      "cute_pet_sales_chart" => [
        "type" => "chart",
        "chart_data" => [
          "rows" => [
            [
              "cells" => [
                [
                  "type" => "string",
                  "value" => "Geographic Region"
                ],
                [
                  "type" => "string",
                  "value" => "Sales (millions AUD)"
                ],
                [
                  "type" => "string",
                  "value" => "Target met?"
                ],
                [
                  "type" => "string",
                  "value" => "Date met"
                ]
              ]
            ],
            [
              "cells" => [
                [
                  "type" => "string",
                  "value" => "Asia Pacific"
                ],
                [
                  "type" => "number",
                  "value" => 10.2
                ],
                [
                  "type" => "boolean",
                  "value" => true
                ],
                [
                  "type" => "date",
                  "value" => 1721944387
                ]
              ]
            ],
            [
              "cells" => [
                [
                  "type" => "string",
                  "value" => "EMEA"
                ],
                [
                  "type" => "number",
                  "value" => 13.8
                ],
                [
                  "type" => "boolean",
                  "value" => false
                ],
                [
                  "type" => "date"
                ]
              ]
            ]
          ]
        ]
      ]
    ]
  ])
));


$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);


if (empty($err)) {
  echo $response;
} else {
  echo "Error: " . $err;
}
PHP
require 'net/http'
require 'uri'


url = URI('https://api.canva.com/rest/v1/autofills')
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true


request = Net::HTTP::Post.new(url)
request['Authorization'] = 'Bearer {token}'
request['Content-Type'] = 'application/json'
request.body = <<REQUEST_BODY
{
  "brand_template_id": "DAFVztcvd9z",
  "title": "string",
  "data": {
    "cute_pet_image_of_the_day": {
      "type": "image",
      "asset_id": "Msd59349ff"
    },
    "cute_pet_witty_pet_says": {
      "type": "text",
      "text": "It was like this when I got here!"
    },
    "cute_pet_sales_chart": {
      "type": "chart",
      "chart_data": {
        "rows": [
          {
            "cells": [
              {
                "type": "string",
                "value": "Geographic Region"
              },
              {
                "type": "string",
                "value": "Sales (millions AUD)"
              },
              {
                "type": "string",
                "value": "Target met?"
              },
              {
                "type": "string",
                "value": "Date met"
              }
            ]
          },
          {
            "cells": [
              {
                "type": "string",
                "value": "Asia Pacific"
              },
              {
                "type": "number",
                "value": 10.2
              },
              {
                "type": "boolean",
                "value": true
              },
              {
                "type": "date",
                "value": 1721944387
              }
            ]
          },
          {
            "cells": [
              {
                "type": "string",
                "value": "EMEA"
              },
              {
                "type": "number",
                "value": 13.8
              },
              {
                "type": "boolean",
                "value": false
              },
              {
                "type": "date"
              }
            ]
          }
        ]
      }
    }
  }
}
REQUEST_BODY


response = http.request(request)
puts response.read_body
RUBY

Success response

If successful, the endpoint returns a 200 response with a JSON body with the following parameters:

jobDesignAutofillJob

Details about the autofill job.

idstring

ID of the asynchronous job that is creating the design using the provided data.

statusstring

Status of the design autofill job.

Available values:

  • in_progress
  • success
  • failed
resultDesignAutofillJobResult
Optional

Result of the design autofill job. Only present if job status is success.

Design has been created and saved to user's root folder.

typestring

Available values: The only valid value is create_design.

designDesignSummary

Basic details about the design, such as the design's ID, title, and URL.

idstring

The design ID.

urlsDesignLinks

A temporary set of URLs for viewing or editing the design.

edit_urlstring

A temporary editing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support return navigation workflows.

This is not a permanent URL, it is only valid for 30 days.

view_urlstring

A temporary viewing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support return navigation workflows.

This is not a permanent URL, it is only valid for 30 days.

created_atinteger

When the design was created in Canva, as a Unix timestamp (in seconds since the Unix Epoch).

updated_atinteger

When the design was last updated in Canva, as a Unix timestamp (in seconds since the Unix Epoch).

titlestring
Optional

The design title.

urlstring
Optional

URL of the design.

thumbnailThumbnail
Optional

A thumbnail image representing the object.

widthinteger

The width of the thumbnail image in pixels.

heightinteger

The height of the thumbnail image in pixels.

urlstring

A URL for retrieving the thumbnail image. This URL expires after 15 minutes. This URL includes a query string that's required for retrieving the thumbnail.

page_countinteger
Optional

The total number of pages in the design. Some design types don't have pages (for example, Canva docs).

errorAutofillError
Optional

If the autofill job fails, this object provides details about the error.

codestring

Available values:

  • autofill_error
  • thumbnail_generation_error
  • create_design_error
messagestring

A human-readable description of what went wrong.

Example responses

In progress job

{
  "job": {
    "id": "450a76e7-f96f-43ae-9c37-0e1ce492ac72",
    "status": "in_progress"
  }
}
JSON

Successfully completed job

{
  "job": {
    "id": "450a76e7-f96f-43ae-9c37-0e1ce492ac72",
    "status": "success",
    "result": {
      "type": "create_design",
      "design": {
        "id": "DAFVztcvd9z",
        "title": "My summer holiday",
        "url": "https://www.canva.com/design/DAFVztcvd9z/edit",
        "thumbnail": {
          "width": 595,
          "height": 335,
          "url": "https://document-export.canva.com/Vczz9/zF9vzVtdADc/2/thumbnail/0001.png?<query-string>"
        }
      }
    }
  }
}
JSON

Failed job

{
  "job": {
    "id": "450a76e7-f96f-43ae-9c37-0e1ce492ac72",
    "status": "failed",
    "error": {
      "code": "autofill_error",
      "message": "Error autofilling design from brand template"
    }
  }
}
JSON

Error responses

400 Bad Request

codestring

A short string indicating what failed. This field can be used to handle errors programmatically. For a complete list of error codes, see Error responses.

messagestring

A human-readable description of what went wrong.

Example error response

{
  "code": "bad_request_params",
  "message": "Design title invalid"
}
JSON

403 Forbidden

codestring

A short string indicating what failed. This field can be used to handle errors programmatically. For a complete list of error codes, see Error responses.

messagestring

A human-readable description of what went wrong.

Example error response

{
  "code": "permission_denied",
  "message": "Not allowed to access brand template with id '{brandTemplateId}'"
}
JSON

404 Not Found

codestring

A short string indicating what failed. This field can be used to handle errors programmatically. For a complete list of error codes, see Error responses.

messagestring

A human-readable description of what went wrong.

Example error response

{
  "code": "not_found",
  "message": "Brand template with id '{brandTemplateId}' not found"
}
JSON

Try it out

Step 1: Enter your access token

To get started, generate an access token or provide your own below