Canva

Canva Connection

Put Canva to Work with @Human Automations and @Human Agents

The Canva Connection documents all Triggers, Actions and Query Operations available for creating automations via the Canva API.

What can you do with the Canva Connection?

• Connect to the Canva API in a few clicks

• Use the related Canva Operations (see below) in @Human Automations or @Human Agents

Related Operations

Trigger Operations

Asset Upload Completed

Triggers on: asset/asset_upload_completed

Triggered when an asset upload job has finished.

Autofill Job Completed

Triggers on: autofill/autofill_job_completed

Triggered when an autofill job has finished.

Comment Created

Triggers on: comment/comment_created

Triggered when a new comment is created on a design.

Design Created

Triggers on: design/design_created

Triggered when a new design is created.

Design Updated

Triggers on: design/design_updated

Triggered when an existing design is updated.

Design Deleted

Triggers on: design/design_deleted

Triggered when a design is deleted.

Design Published

Triggers on: design/design_published

Triggered when a design is published.

Import Job Completed

Triggers on: design_import/import_job_completed

Triggered when a design import job has finished.

Export Job Completed

Triggers on: export/export_job_completed

Triggered when an export job has finished.

Folder Created

Triggers on: folder/folder_created

Triggered when a new folder is created.

Folder Updated

Triggers on: folder/folder_updated

Triggered when a folder's details are updated.

Folder Deleted

Triggers on: folder/folder_deleted

Triggered when a folder is deleted.

Resize Job Completed

Triggers on: resize/resize_job_completed

Triggered when a resize job has finished.

Action Operations

Action: Upload Asset

Action: Autofill Design From Brand Template

Action: Import Design

Action: API Request

Query Operations

Example link

Related Automations

Example link

Obtaining Access Credentials

To obtain a Personal Access Token (PAT) for Canva (system-to-system access), follow these steps:

Prerequisites

• A Canva Pro/Enterprise account (PATs are not available for free accounts).

• Admin access if generating tokens for a team.

Steps

1. Log in to your Canva account at https://www.canva.com.

2. Click your profile icon (top-right) → Account Settings.

3. Navigate to Apps & Integrations → API & Developers.

4. Under Personal Access Tokens, click Generate Token.

5. Enter a Token Name (e.g., "API Integration").

6. Select Scopes (permissions) for the token:

   • Common scopes: design:read, design:write, user:read.

7. Click Generate Token → Copy the token immediately (it won’t be shown again).

Configuring Webhooks

1. Log in to the Canva Developer Portal at https://www.canva.dev/.

2. Select your integration from the Your integrations list.

3. Click on Configuration in the left-hand navigation menu.

4. Locate the Webhook URL section and enter your server's Publicly accessible URL.

5. Click Save changes.

6. Navigate to the Scopes page in the left sidebar.

7. Enable the scopes corresponding to the events you wish to receive (e.g., collaboration:event).

8. Click Save changes.

Code (Apache v2.0): Service Connectivity and Metadata

{
  "handle": "canva",
  "status": "active",
  "meta": {
    "short": "Canva",
    "description": "Connect to Canva's design platform to manage designs, templates, and assets.",
    "icon": "canva",
    "tags": ["design", "graphics", "templates", "creative"]
  },
  "service": {
    "baseURL": {
      "value": "https://api.canva.com/v1"
    },
    "protocol": "https",
    "contentType": "application/json",
    "headers": {
      "Accept": {
        "value": "application/json"
      },
      "Content-Type": {
        "value": "application/json"
      }
    },
    "auth": {
      "method": "system_to_system",
      "params": {}
    }
  }
}

Code (Apache v2.0): List of External Resources and Internal Mapping

  {
    "handle": "app",
    "meta": {
      "short": "App",
      "description": "Manage app resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [],
    "operations": {
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/apps/{appId}/jwks"
        },
        "headers": {},
        "meta": {
          "description": "Returns the Json Web Key Set (public keys) of an app. These keys are used to"
        }
      }
    }
  },
  {
    "handle": "asset",
    "meta": {
      "short": "Asset",
      "description": "Manage asset resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [
      {
        "event": "asset_upload_completed",
        "path": "/webhooks/canva/asset_upload_completed",
        "payload": [
          { "name": "asset_id", "type": "String", "selector": ["asset", "id"], "meta": { "description": "ID of the uploaded asset." } },
          { "name": "name", "type": "String", "selector": ["asset", "name"], "meta": { "description": "Name of the asset." } },
          { "name": "status", "type": "String", "selector": ["job", "status"], "meta": { "description": "Upload job status." } }
        ]
      }
    ],
    "operations": {
      "delete": {
        "method": "DELETE",
        "path": {
          "value": "/v1/assets/{assetId}"
        },
        "headers": {},
        "meta": {
          "description": "You can delete an asset by specifying its `assetId`. This operation mirrors the behavior"
        }
      },
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/assets/{assetId}"
        },
        "headers": {},
        "meta": {
          "description": "You can retrieve the metadata of an asset by specifying its `assetId`."
        }
      },
      "patch": {
        "method": "PATCH",
        "path": {
          "value": "/v1/assets/{assetId}"
        },
        "headers": {},
        "meta": {
          "description": "You can update the name and tags of an asset by specifying its `assetId`. Updating the tags"
        }
      },
      "post": {
        "method": "POST",
        "path": {
          "value": "/v1/asset-uploads"
        },
        "headers": {},
        "meta": {
          "description": "Starts a new [asynchronous job](https://www.canva.dev/docs/connect/api-requests-responses/#asynchronous-job-endpoints) to upload an asset to the user's content library. Supported file types for assets are listed in the [Assets API overview](https://www.canva.dev/docs/connect/api-reference/assets/)."
        }
      },
      "get_jobId": {
        "method": "GET",
        "path": {
          "value": "/v1/url-asset-uploads/{jobId}"
        },
        "headers": {},
        "meta": {
          "description": "<Warning>"
        }
      },
      "post_url-asset-uploads": {
        "method": "POST",
        "path": {
          "value": "/v1/url-asset-uploads"
        },
        "headers": {},
        "meta": {
          "description": "<Warning>"
        }
      }
    }
  },
  {
    "handle": "autofill",
    "meta": {
      "short": "Autofill",
      "description": "Manage autofill resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [
      {
        "event": "autofill_job_completed",
        "path": "/webhooks/canva/autofill_job_completed",
        "payload": [
          { "name": "job_id", "type": "String", "selector": ["job", "id"], "meta": { "description": "ID of the autofill job." } },
          { "name": "status", "type": "String", "selector": ["job", "status"], "meta": { "description": "Status of the autofill job." } },
          { "name": "design_id", "type": "String", "selector": ["job", "design_id"], "meta": { "description": "ID of the resulting design." } }
        ]
      }
    ],
    "operations": {
      "post": {
        "method": "POST",
        "path": {
          "value": "/v1/autofills"
        },
        "headers": {},
        "meta": {
          "description": "WARNING: Brand templates were migrated to use a new ID format in September 2025. If your integration stores brand template IDs, you'll need to migrate to use the new IDs. Old brand template IDs will continue to be accepted for 6 months to give you time to migrate to the new IDs."
        }
      },
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/autofills/{jobId}"
        },
        "headers": {},
        "meta": {
          "description": "AVAILABILITY: To use this API, your integration must act on behalf of a user that's a member of a [Canva Enterprise](https://www.canva.com/enterprise/) organization."
        }
      }
    }
  },
  {
    "handle": "brand_template",
    "meta": {
      "short": "Brand Template",
      "description": "Manage brand template resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [],
    "operations": {
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/brand-templates"
        },
        "headers": {},
        "meta": {
          "description": "WARNING: Brand templates were migrated to use a new ID format in September 2025. If your integration stores brand template IDs, you'll need to migrate to use the new IDs. Old brand template IDs will continue to be accepted for 6 months to give you time to migrate to the new IDs."
        }
      },
      "get_brandTemplateId": {
        "method": "GET",
        "path": {
          "value": "/v1/brand-templates/{brandTemplateId}"
        },
        "headers": {},
        "meta": {
          "description": "WARNING: Brand templates were migrated to use a new ID format in September 2025. If your integration stores brand template IDs, you'll need to migrate to use the new IDs. Old brand template IDs will continue to be accepted for 6 months to give you time to migrate to the new IDs."
        }
      },
      "get_dataset": {
        "method": "GET",
        "path": {
          "value": "/v1/brand-templates/{brandTemplateId}/dataset"
        },
        "headers": {},
        "meta": {
          "description": "WARNING: Brand templates were migrated to use a new ID format in September 2025. If your integration stores brand template IDs, you'll need to migrate to use the new IDs. Old brand template IDs will continue to be accepted for 6 months to give you time to migrate to the new IDs."
        }
      }
    }
  },
  {
    "handle": "comment",
    "meta": {
      "short": "Comment",
      "description": "Manage comment resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [
      {
        "event": "comment_created",
        "path": "/webhooks/canva/comment_created",
        "payload": [
          { "name": "comment_id", "type": "String", "selector": ["comment", "id"], "meta": { "description": "ID of the comment." } },
          { "name": "design_id", "type": "String", "selector": ["comment", "design_id"], "meta": { "description": "ID of the design the comment belongs to." } },
          { "name": "message", "type": "String", "selector": ["comment", "message"], "meta": { "description": "Text content of the comment." } }
        ]
      }
    ],
    "operations": {
      "post": {
        "method": "POST",
        "path": {
          "value": "/v1/comments"
        },
        "headers": {},
        "meta": {
          "description": "<Warning>"
        }
      },
      "post_replies": {
        "method": "POST",
        "path": {
          "value": "/v1/designs/{designId}/comments/{threadId}/replies"
        },
        "headers": {},
        "meta": {
          "description": "<Warning>"
        }
      },
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/designs/{designId}/comments/{threadId}/replies"
        },
        "headers": {},
        "meta": {
          "description": "<Warning>"
        }
      },
      "get_threadId": {
        "method": "GET",
        "path": {
          "value": "/v1/designs/{designId}/comments/{threadId}"
        },
        "headers": {},
        "meta": {
          "description": "<Warning>"
        }
      },
      "get_replyId": {
        "method": "GET",
        "path": {
          "value": "/v1/designs/{designId}/comments/{threadId}/replies/{replyId}"
        },
        "headers": {},
        "meta": {
          "description": "<Warning>"
        }
      },
      "post_comments": {
        "method": "POST",
        "path": {
          "value": "/v1/designs/{designId}/comments"
        },
        "headers": {},
        "meta": {
          "description": "<Warning>"
        }
      }
    }
  },
  {
    "handle": "connect",
    "meta": {
      "short": "Connect",
      "description": "Manage connect resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [],
    "operations": {
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/connect/keys"
        },
        "headers": {},
        "meta": {
          "description": "<Warning>"
        }
      }
    }
  },
  {
    "handle": "design",
    "meta": {
      "short": "Design",
      "description": "Manage design resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [
      {
        "event": "design_created",
        "path": "/webhooks/canva/design_created",
        "payload": [
          { "name": "design_id", "type": "String", "selector": ["design", "id"], "meta": { "description": "ID of the created design." } },
          { "name": "title", "type": "String", "selector": ["design", "title"], "meta": { "description": "Title of the design." } }
        ]
      },
      {
        "event": "design_updated",
        "path": "/webhooks/canva/design_updated",
        "payload": [
          { "name": "design_id", "type": "String", "selector": ["design", "id"], "meta": { "description": "ID of the updated design." } },
          { "name": "title", "type": "String", "selector": ["design", "title"], "meta": { "description": "Title of the design." } }
        ]
      },
      {
        "event": "design_deleted",
        "path": "/webhooks/canva/design_deleted",
        "payload": [
          { "name": "design_id", "type": "String", "selector": ["design", "id"], "meta": { "description": "ID of the deleted design." } }
        ]
      },
      {
        "event": "design_published",
        "path": "/webhooks/canva/design_published",
        "payload": [
          { "name": "design_id", "type": "String", "selector": ["design", "id"], "meta": { "description": "ID of the published design." } },
          { "name": "url", "type": "String", "selector": ["design", "url"], "meta": { "description": "URL of the published design." } }
        ]
      }
    ],
    "operations": {
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/designs"
        },
        "headers": {},
        "meta": {
          "description": "Lists metadata for all the designs in a Canva user's"
        }
      },
      "post": {
        "method": "POST",
        "path": {
          "value": "/v1/designs"
        },
        "headers": {},
        "meta": {
          "description": "Creates a new Canva design. To create a new design, you can either:"
        }
      },
      "get_designId": {
        "method": "GET",
        "path": {
          "value": "/v1/designs/{designId}"
        },
        "headers": {},
        "meta": {
          "description": "Gets the metadata for a design. This includes owner information, URLs for editing and viewing, and thumbnail information."
        }
      },
      "get_pages": {
        "method": "GET",
        "path": {
          "value": "/v1/designs/{designId}/pages"
        },
        "headers": {},
        "meta": {
          "description": "<Warning>"
        }
      },
      "get_export-formats": {
        "method": "GET",
        "path": {
          "value": "/v1/designs/{designId}/export-formats"
        },
        "headers": {},
        "meta": {
          "description": "Lists the available file formats for [exporting a design](https://www.canva.dev/docs/connect/api-reference/exports/create-design-export-job/)."
        }
      }
    }
  },
  {
    "handle": "design_import",
    "meta": {
      "short": "Design Import",
      "description": "Manage design import resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [
      {
        "event": "import_job_completed",
        "path": "/webhooks/canva/import_job_completed",
        "payload": [
          { "name": "job_id", "type": "String", "selector": ["job", "id"], "meta": { "description": "ID of the import job." } },
          { "name": "status", "type": "String", "selector": ["job", "status"], "meta": { "description": "Status of the job." } },
          { "name": "design_id", "type": "String", "selector": ["job", "design_id"], "meta": { "description": "ID of the resulting design." } }
        ]
      }
    ],
    "operations": {
      "post": {
        "method": "POST",
        "path": {
          "value": "/v1/imports"
        },
        "headers": {},
        "meta": {
          "description": "Starts a new [asynchronous job](https://www.canva.dev/docs/connect/api-requests-responses/#asynchronous-job-endpoints) to import an external file as a new design in Canva."
        }
      },
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/imports/{jobId}"
        },
        "headers": {},
        "meta": {
          "description": "Gets the result of a design import job created using the [Create design import job API](https://www.canva.dev/docs/connect/api-reference/design-imports/create-design-import-job/)."
        }
      },
      "post_url-imports": {
        "method": "POST",
        "path": {
          "value": "/v1/url-imports"
        },
        "headers": {},
        "meta": {
          "description": "Starts a new [asynchronous job](https://www.canva.dev/docs/connect/api-requests-responses/#asynchronous-job-endpoints) to import an external file from a URL as a new design in Canva."
        }
      },
      "get_jobId": {
        "method": "GET",
        "path": {
          "value": "/v1/url-imports/{jobId}"
        },
        "headers": {},
        "meta": {
          "description": "Gets the result of a URL import job created using the [Create URL import job API](https://www.canva.dev/docs/connect/api-reference/design-imports/create-url-import-job/)."
        }
      }
    }
  },
  {
    "handle": "export",
    "meta": {
      "short": "Export",
      "description": "Manage export resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [
      {
        "event": "export_job_completed",
        "path": "/webhooks/canva/export_job_completed",
        "payload": [
          { "name": "job_id", "type": "String", "selector": ["job", "id"], "meta": { "description": "ID of the export job." } },
          { "name": "status", "type": "String", "selector": ["job", "status"], "meta": { "description": "Status of the job." } },
          { "name": "url", "type": "String", "selector": ["job", "export_url"], "meta": { "description": "URL to download the exported file." } }
        ]
      }
    ],
    "operations": {
      "post": {
        "method": "POST",
        "path": {
          "value": "/v1/exports"
        },
        "headers": {},
        "meta": {
          "description": "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"
        }
      },
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/exports/{exportId}"
        },
        "headers": {},
        "meta": {
          "description": "Gets the result of a design export job that was created using the [Create design export job API](https://www.canva.dev/docs/connect/api-reference/exports/create-design-export-job/)."
        }
      }
    }
  },
  {
    "handle": "folder",
    "meta": {
      "short": "Folder",
      "description": "Manage folder resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [
      {
        "event": "folder_created",
        "path": "/webhooks/canva/folder_created",
        "payload": [
          { "name": "folder_id", "type": "String", "selector": ["folder", "id"], "meta": { "description": "ID of the created folder." } },
          { "name": "name", "type": "String", "selector": ["folder", "name"], "meta": { "description": "Name of the folder." } }
        ]
      },
      {
        "event": "folder_updated",
        "path": "/webhooks/canva/folder_updated",
        "payload": [
          { "name": "folder_id", "type": "String", "selector": ["folder", "id"], "meta": { "description": "ID of the updated folder." } },
          { "name": "name", "type": "String", "selector": ["folder", "name"], "meta": { "description": "Name of the folder." } }
        ]
      },
      {
        "event": "folder_deleted",
        "path": "/webhooks/canva/folder_deleted",
        "payload": [
          { "name": "folder_id", "type": "String", "selector": ["folder", "id"], "meta": { "description": "ID of the deleted folder." } }
        ]
      }
    ],
    "operations": {
      "delete": {
        "method": "DELETE",
        "path": {
          "value": "/v1/folders/{folderId}"
        },
        "headers": {},
        "meta": {
          "description": "Deletes a folder with the specified `folderID`."
        }
      },
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/folders/{folderId}"
        },
        "headers": {},
        "meta": {
          "description": "Gets the name and other details of a folder using a folder's `folderID`."
        }
      },
      "patch": {
        "method": "PATCH",
        "path": {
          "value": "/v1/folders/{folderId}"
        },
        "headers": {},
        "meta": {
          "description": "Updates a folder's details using its `folderID`."
        }
      },
      "get_items": {
        "method": "GET",
        "path": {
          "value": "/v1/folders/{folderId}/items"
        },
        "headers": {},
        "meta": {
          "description": "Lists the items in a folder, including each item's `type`."
        }
      },
      "post": {
        "method": "POST",
        "path": {
          "value": "/v1/folders/move"
        },
        "headers": {},
        "meta": {
          "description": "Moves an item to another folder. You must specify the folder ID of the destination folder, as well as the ID of the item you want to move."
        }
      },
      "post_folders": {
        "method": "POST",
        "path": {
          "value": "/v1/folders"
        },
        "headers": {},
        "meta": {
          "description": "Creates a folder in one of the following locations:"
        }
      }
    }
  },
  {
    "handle": "oauth",
    "meta": {
      "short": "Oauth",
      "description": "Manage oauth resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [],
    "operations": {
      "post": {
        "method": "POST",
        "path": {
          "value": "/v1/oauth/token"
        },
        "headers": {},
        "meta": {
          "description": "This endpoint implements the OAuth 2.0 `token` endpoint, as part of the Authorization Code flow with Proof Key for Code Exchange (PKCE). For more information, see [Authentication](https://www.canva.dev/docs/connect/authentication/)."
        }
      },
      "post_introspect": {
        "method": "POST",
        "path": {
          "value": "/v1/oauth/introspect"
        },
        "headers": {},
        "meta": {
          "description": "Introspect an access token to see whether it is valid and active. You can also verify some token properties, such as its claims, scopes, and validity times."
        }
      },
      "post_revoke": {
        "method": "POST",
        "path": {
          "value": "/v1/oauth/revoke"
        },
        "headers": {},
        "meta": {
          "description": "Revoke an access token or a refresh token."
        }
      }
    }
  },
  {
    "handle": "oidc",
    "meta": {
      "short": "Oidc",
      "description": "Manage oidc resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [],
    "operations": {
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/oidc/jwks"
        },
        "headers": {},
        "meta": {
          "description": "Gets the JSON Web Key Set (public keys) for OIDC. These keys are used to verify JWTs in OpenID Connect flows."
        }
      },
      "get_userinfo": {
        "method": "GET",
        "path": {
          "value": "/v1/oidc/userinfo"
        },
        "headers": {},
        "meta": {
          "description": "Fetches the current UserInfo claims for the authorized user. This is the same fields"
        }
      }
    }
  },
  {
    "handle": "resize",
    "meta": {
      "short": "Resize",
      "description": "Manage resize resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [
      {
        "event": "resize_job_completed",
        "path": "/webhooks/canva/resize_job_completed",
        "payload": [
          { "name": "job_id", "type": "String", "selector": ["job", "id"], "meta": { "description": "ID of the resize job." } },
          { "name": "status", "type": "String", "selector": ["job", "status"], "meta": { "description": "Status of the job." } },
          { "name": "design_id", "type": "String", "selector": ["job", "design_id"], "meta": { "description": "ID of the resulting design." } }
        ]
      }
    ],
    "operations": {
      "post": {
        "method": "POST",
        "path": {
          "value": "/v1/resizes"
        },
        "headers": {},
        "meta": {
          "description": "AVAILABILITY: To use this API, your integration must act on behalf of a user that's on a Canva plan with premium features (such as Canva Pro)."
        }
      },
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/resizes/{jobId}"
        },
        "headers": {},
        "meta": {
          "description": "AVAILABILITY: To use this API, your integration must act on behalf of a user that's on a Canva plan with premium features (such as Canva Pro)."
        }
      }
    }
  },
  {
    "handle": "user",
    "meta": {
      "short": "User",
      "description": "Manage user resources via Canva Connect API."
    },
    "endpoint": {
      "value": ""
    },
    "webhooks": [],
    "operations": {
      "get": {
        "method": "GET",
        "path": {
          "value": "/v1/users/me"
        },
        "headers": {},
        "meta": {
          "description": "Returns the User ID and Team ID of the user"
        }
      },
      "get_capabilities": {
        "method": "GET",
        "path": {
          "value": "/v1/users/me/capabilities"
        },
        "headers": {},
        "meta": {
          "description": "Lists the API capabilities for the user account associated with the provided access token. For more information, see [Capabilities](https://www.canva.dev/docs/connect/capabilities/)."
        }
      },
      "get_profile": {
        "method": "GET",
        "path": {
          "value": "/v1/users/me/profile"
        },
        "headers": {},
        "meta": {
          "description": "Currently, this returns the display name of the user account associated with the provided access token. More user information is expected to be included in the future."
        }
      }
    }
  }
]