Canva

Let your agents find, create, organize and export the designs in your Canva account, and import files from a URL as new designs.

Connection

Authentication: OAuth 2.0 — you authorize Atako via Canva’s consent screen; no key to copy.
Scopes requested:
- design:meta:read
- design:content:read
- design:content:write
- folder:read
- folder:write
- asset:read
- asset:write
- profile:read

Nothing to paste: click Connect and approve Atako in your Canva account. Prerequisite on the Atako side — an administrator opens the Canva Developer Portal (https://www.canva.com/developers/apps) → Your apps → Create an app (Public), then Outside Canva → Start integrating. In Outside Canva → Configuration: keep “Canva REST APIs” on, under Scopes tick design:meta (Read), design:content (Read and Write), folder (Read and Write), asset (Read and Write) and profile (Read), and under Credentials copy the Client ID and click Generate secret. In Outside Canva → Redirect URLs, set URL 1 to ${API_URL}/integrations/oauth/callback. Put the Client ID and secret in INTEGRATION_OAUTH_CANVA_CLIENT_ID / _CLIENT_SECRET. A public app must pass Canva’s review (submission checklist) before it is available to all Canva users.See Canva’s documentation.

Read actions (10)

Action	Description
`get_asset`	Fetch an asset’s metadata (name, tags, type, thumbnail, dates). Asset IDs come from list_folder_items (image items).
`get_current_user`	Fetch the connected Canva user’s user_id and team_id (no scope needed — connection check).
`get_design`	Fetch a design’s metadata: title, owner, edit/view URLs (valid 30 days), thumbnail, page_count, dates.
`get_design_export_formats`	List the export formats a design supports (pdf, jpg, png, pptx, gif, mp4, html_bundle, html_standalone, csv), with the page numbers each one covers — check before create_design_export_job.
`get_design_export_job`	Poll an export job started by create_design_export_job: status in_progress \| success \| failed; on success, urls = download links (one per page, valid 24 hours).
`get_folder`	Fetch a folder’s name and details.
`get_url_import_job`	Poll a URL import job started by create_url_import_job: status in_progress \| success \| failed; on success, result.designs lists the created design(s).
`get_user_profile`	Fetch the connected Canva user’s display name.
`list_designs`	List or search the user’s designs and the designs shared with them (id, title, urls, thumbnail, page_count). Paginate with the returned continuation token.
`list_folder_items`	List the designs, folders and image assets in a folder, each with its type and ID. Start from folderId “root” (top of Projects) or “uploads”. Paginate with the returned continuation token.

Write actions (7)

Action	Description
`create_design`	Create a new design (blank designs never edited are deleted by Canva after 7 days). Arguments: design_type (object, optional) — either { type: “preset”, name: “doc” \| “email” \| “presentation” \| “whiteboard” } or { type: “custom”, width: integer 40-8000 px, height: integer 40-8000 px, width × height ≤ 25,000,000 }; title (string 1-255, optional); asset_id (string, optional — an image asset to place in the design). At least one of design_type or asset_id is required.
`create_design_export_job`	Start exporting a design to a file; poll get_design_export_job with the returned job.id. Arguments: design_id (string, required); format (object, required), by format.type — “pdf”: export_quality (“regular”\|“pro”), size (“a4”\|“a3”\|“letter”\|“legal”, Canva Docs only), pages; “jpg”: quality (integer 1-100, REQUIRED), export_quality, width/height (integer 40-25000 px), pages; “png”: export_quality, width/height, lossless (boolean), transparent_background (boolean), as_single_image (boolean), pages; “pptx”: pages; “gif”: export_quality, width/height, pages; “mp4”: quality (REQUIRED: horizontal_480p\|horizontal_720p\|horizontal_1080p\|horizontal_4k\|vertical_480p\|vertical_720p\|vertical_1080p\|vertical_4k), export_quality, pages; “html_bundle” / “html_standalone”: pages (one page); “csv”: pages. pages = array of integers ≥ 1, omitted = all pages.
`create_folder`	Create a folder. Arguments: name (string 1-255, required); parent_folder_id (string, required — “root” = top level of Projects, “uploads” = Uploads folder, or a folder ID).
`create_url_import_job`	Import a publicly reachable file (PDF, PowerPoint, Word, Keynote, Illustrator…) from a URL as a new Canva design; poll get_url_import_job with the returned job.id. Arguments: title (string 1-255, required); url (string ≤ 2048, required — public URL); mime_type (string, optional — auto-detected when omitted).
`move_folder_item`	Move a design, folder or image into another folder. Arguments: item_id (string, required — video assets not supported); to_folder_id (string, required — “root” = top level of Projects). Fails with item_in_multiple_folders if the item sits in several folders.
`update_asset`	Rename an asset and/or replace its tags. Arguments: assetId (string, required); name (string ≤ 50, optional); tags (array of strings ≤ 50 chars, max 50, optional — REPLACES all existing tags).
`update_folder`	Rename a folder. Arguments: folderId (string, required); name (string 1-255, required — new name).

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Using integrations

Communication

Scheduling

Project management

Docs & design

Files & storage

CRM & sales

Customer support

HR & recruiting

Commerce & billing

Developer tools

Observability & analytics

AI & media

Connection

Read actions (10)

Write actions (7)

Permissions

​Connection

​Read actions (10)

​Write actions (7)

​Permissions

Connection

Read actions (10)

Write actions (7)

Permissions