---
title: "POST /v1/exports"
method: POST
path: "/v1/exports"
tags: ["export"]
---

# POST /v1/exports

`POST /v1/exports`

Starts a new [asynchronous job](https://www.canva.dev/docs/connect/api-requests-responses/#asynchronous-job-endpoints) to export a file from Canva. Once the exported file is generated, you can download
it using the URL(s) provided. The download URLs are only valid for 24 hours.

The request requires the design ID and the exported file format type.

Supported file formats (and export file type values): JPG (`jpg`), PNG (`png`), GIF (`gif`), Microsoft PowerPoint (`pptx`), MP4 (`mp4`), PDF (`pdf`), CSV (`csv`), HTML bundle (`html_bundle`), and standalone HTML (`html_standalone`).

<Note>

This endpoint has the following additional rate limits:

  - **Integration throttle:** Each integration can export a maximum of 750 times per 5-minute window, and 5,000 times per 24-hour window.
  - **Document throttle:** Each document can be exported a maximum of 75 times per 5-minute window.
  - **User throttle:** Each user can export a maximum of 75 times per 5-minute window, and 500 times per 24-hour window.

</Note>
<Note>

For more information on the workflow for using asynchronous jobs, see [API requests and responses](https://www.canva.dev/docs/connect/api-requests-responses/#asynchronous-job-endpoints). You can check the status and get the results of export jobs created with this API using the [Get design export job API](https://www.canva.dev/docs/connect/api-reference/exports/get-design-export-job/).

</Note>

## Request body

- CreateDesignExportJobRequest — Body parameters for starting an export job for a design. It must include a design ID, and one of the supported export formats.
  - `design_id` string, required — The design ID.
  - `format` union, required — Details about the desired export format.
    - object — Export the design as a PDF. Providing a paper size is optional.
      - `type` 'pdf', required
      - `export_quality` 'regular' | 'pro' — Specifies the export quality of the design.
      - `size` 'a4' | 'a3' | 'letter' | 'legal' — The paper size of the export PDF file. The `size` attribute is only supported for Documents (Canva Docs).
      - `pages` integer[] — To specify which pages to export in a multi-page design, provide the page numbers as an array. The first page in a design is page `1`. If `pages` isn't specified, all the pages are exported.
    - object — Export the design as a JPEG. Compression quality must be provided. Height or width (or both) may be specified, otherwise the file will be exported at it's default size. If the user is on the Canva Free plan, the export height and width for a fixed-dimension design can't be upscaled by more than a factor of `1.125`.
      - `type` 'jpg', required
      - `export_quality` 'regular' | 'pro' — Specifies the export quality of the design.
      - `quality` integer, required — For the `jpg` type, the `quality` of the exported JPEG determines how compressed the exported file should be. A _low_ `quality` value will create a file with a smaller file size, but the resulting file will have pixelated artifacts when compared to a file created with a _high_ `quality` value.
      - `height` integer — Specify the height in pixels of the exported image. Note the following behavior: - If no height or width is specified, the image is exported using the dimensions of the design. - If only one of height or width is specified, then the image is scaled to match that dimension, respecting the design's aspect ratio. - If both the height and width are specified, but the values don't match the design's aspect ratio, the export defaults to the larger dimension.
      - `width` integer — Specify the width in pixels of the exported image. Note the following behavior: - If no width or height is specified, the image is exported using the dimensions of the design. - If only one of width or height is specified, then the image is scaled to match that dimension, respecting the design's aspect ratio. - If both the width and height are specified, but the values don't match the design's aspect ratio, the export defaults to the larger dimension.
      - `pages` integer[] — To specify which pages to export in a multi-page design, provide the page numbers as an array. The first page in a design is page `1`. If `pages` isn't specified, all the pages are exported.
    - object — Export the design as a PNG. Height or width (or both) may be specified, otherwise the file will be exported at it's default size. You may also specify whether to export the file losslessly, and whether to export a multi-page design as a single image. If the user is on the Canva Free plan, the export height and width for a fixed-dimension design can't be upscaled by more than a factor of `1.125`.
      - `type` 'png', required
      - `export_quality` 'regular' | 'pro' — Specifies the export quality of the design.
      - `height` integer — Specify the height in pixels of the exported image. Note the following behavior: - If no height or width is specified, the image is exported using the dimensions of the design. - If only one of height or width is specified, then the image is scaled to match that dimension, respecting the design's aspect ratio. - If both the height and width are specified, but the values don't match the design's aspect ratio, the export defaults to the larger dimension.
      - `width` integer — Specify the width in pixels of the exported image. Note the following behavior: - If no width or height is specified, the image is exported using the dimensions of the design. - If only one of width or height is specified, then the image is scaled to match that dimension, respecting the design's aspect ratio. - If both the width and height are specified, but the values don't match the design's aspect ratio, the export defaults to the larger dimension.
      - `lossless` boolean — If set to `true` (default), the PNG is exported without compression. If set to `false`, the PNG is compressed using a lossy compression algorithm. AVAILABILITY: Lossy PNG compression is only available to users on a Canva plan that has premium features, such as Canva Pro. If the user is on the Canva Free plan and this parameter is set to `false`, the export operation will fail.
      - `transparent_background` boolean — If set to `true`, the PNG is exported with a transparent background. AVAILABILITY: This option is only available to users on a Canva plan that has premium features, such as Canva Pro. If the user is on the Canva Free plan and this parameter is set to `true`, the export operation will fail.
      - `as_single_image` boolean — When `true`, multi-page designs are merged into a single image. When `false` (default), each page is exported as a separate image.
      - `pages` integer[] — To specify which pages to export in a multi-page design, provide the page numbers as an array. The first page in a design is page `1`. If `pages` isn't specified, all the pages are exported.
    - object — Export the design as a PPTX.
      - `type` 'pptx', required
      - `pages` integer[] — To specify which pages to export in a multi-page design, provide the page numbers as an array. The first page in a design is page `1`. If `pages` isn't specified, all the pages are exported.
    - object — Export the design as a GIF. Height or width (or both) may be specified, otherwise the file will be exported at it's default size. Large designs will be scaled down, and aspect ratio will always be maintained.
      - `type` 'gif', required
      - `export_quality` 'regular' | 'pro' — Specifies the export quality of the design.
      - `height` integer — Specify the height in pixels of the exported image. Note the following behavior: - If no height or width is specified, the image is exported using the dimensions of the design. - If only one of height or width is specified, then the image is scaled to match that dimension, respecting the design's aspect ratio. - If both the height and width are specified, but the values don't match the design's aspect ratio, the export defaults to the larger dimension.
      - `width` integer — Specify the width in pixels of the exported image. Note the following behavior: - If no width or height is specified, the image is exported using the dimensions of the design. - If only one of width or height is specified, then the image is scaled to match that dimension, respecting the design's aspect ratio. - If both the width and height are specified, but the values don't match the design's aspect ratio, the export defaults to the larger dimension.
      - `pages` integer[] — To specify which pages to export in a multi-page design, provide the page numbers as an array. The first page in a design is page `1`. If `pages` isn't specified, all the pages are exported.
    - object — Export the design as an MP4. You must specify the quality of the exported video.
      - `type` 'mp4', required
      - `export_quality` 'regular' | 'pro' — Specifies the export quality of the design.
      - `quality` 'horizontal_480p' | 'horizontal_720p' | 'horizontal_1080p' | 'horizontal_4k' | 'vertical_480p' | 'vertical_720p' | 'vertical_1080p' | 'vertical_4k', required — The orientation and resolution of the exported video. Orientation is either `horizontal` or `vertical`, and resolution is one of `480p`, `720p`, `1080p` or `4k`.
      - `pages` integer[] — To specify which pages to export in a multi-page design, provide the page numbers as an array. The first page in a design is page `1`. If `pages` isn't specified, all the pages are exported.
    - object — Export the email design as an HTML bundle. An HTML bundle is a zip file that contains an HTML file and the associated assets.
      - `type` 'html_bundle', required
      - `pages` integer[] — The pages of the design to export. Currently only a single page can be exported. If not provided, the first page of the design is used.
    - object — Export the email design as a standalone HTML file with hosted assets.
      - `type` 'html_standalone', required
      - `pages` integer[] — The pages of the design to export. Currently only a single page can be exported. If not provided, the first page of the design is used.
    - object — Export the design as a CSV file. CSV export is only available for designs that contain tabular data, such as Canva Sheets.
      - `type` 'csv', required
      - `pages` integer[] — To specify which pages to export in a multi-page design, provide the page numbers as an array. The first page in a design is page `1`. If `pages` isn't specified, all the pages are exported.

## Response `200`

OK

- CreateDesignExportJobResponse
  - `job` ExportJob, required — The status of the export job.
    - `id` string, required — The export job ID.
    - `status` 'failed' | 'in_progress' | 'success', required — The export status of the job. A newly created job will be `in_progress` and will eventually become `success` or `failed`.
    - `urls` string[] — Download URL(s) for the completed export job. These URLs expire after 24 hours. Depending on the design type and export format, there is a download URL for each page in the design. The list is sorted by page order.
    - `error` ExportError — If the export fails, this object provides details about the error.
      - `code` 'license_required' | 'approval_required' | 'internal_failure', required — If the export failed, this specifies the reason why it failed.
      - `message` string, required — A human-readable description of what went wrong.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `default` — Error Response

---

[API](https://skmtc.net/canva/apis/canva-connect-api.md) · [All operations](https://skmtc.net/canva/apis/canva-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/canva/canva-connect-api/versions/499c392c7720/schema)