/v1/imports

POST {{baseUrl}}/v1/imports

This API is currently provided as a preview. Be aware of the following:

  • There might be unannounced breaking changes.
  • Any breaking changes to preview APIs won't produce a new API version.
  • Public integrations that use preview APIs will not pass the review process, and can't be made available to all Canva users.

Starts a new job to import an external file as a new design in Canva. The request format for this endpoint has an application/octet-stream body of bytes, and the information about the import is attached using an Import-Metadata header.

Supported formats: PDFs(.pdf), Adobe Illustrator(.ai), Adobe Photoshop(.psd), Microsoft Word(.docx), Microsoft Powerpoint(.pptx), Microsoft Excel(.xls, .xlsx), OpenOffice Draw(.odg), OpenOffice Presentation(.odp), OpenOffice Sheets(.ods), OpenOffice Text(.odt).

You can check the status and get the results of import jobs created with this API using the Get design import job API.

For upload formats and requirements, see Canva Help — Upload formats and requirements.

HEADERS

KeyDatatypeRequiredDescription
Import-Metadatanull(Required)
Content-Typestring
Acceptstring

RESPONSES

status: OK

{"job_id":"\u003cstring\u003e"}