> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Canva

> Create, manage, and export Canva designs, folders, assets, and comments via your connected account.

Use Canva when you need to create or update a design, move files, or export a finished asset. It also works for organizing folders and managing design comments.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Canva account to use for this step. |
| Action | Yes | The Canva action to perform (for example Show account identity, List user designs, Create new design, Get design details). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Canva in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Show account identity** | Returns the connected Canva account identity. |
| **List user designs** | Lists designs available to the connected user. |
| **Create new design** | Creates a new Canva design from a preset, dimensions, or template. |
| **Get design details** | Gets metadata and access information for a design. |
| **Start export job** | Starts an asynchronous export job for a design. |
| **Get export result** | Checks the status and result of a design export job. |
| **Import design file** | Imports an external file as a new Canva design. |
| **Check import status** | Checks the status and result of a design import job. |
| **Upload asset file** | Uploads a file into the Canva content library. |
| **Check upload status** | Checks the status of an asset upload job. |
| **Get asset details** | Gets metadata for an uploaded asset. |
| **Create folder** | Creates a new folder in Canva. |
| **Get folder details** | Gets details for a folder by ID. |
| **Update folder details** | Updates a folder's name. |
| **Move item to folder** | Moves a design, asset, or other item into a folder. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Canva response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Canva if you have not already done that.
2. Add a **Canva** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Show account identity** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Create a design from a file

1. Import design file
2. Check import status
3. Get design details

### Export a finished design

1. List user designs
2. Start export job
3. Get export result

### Organize an asset into a folder

1. Upload asset file
2. Check upload status
3. Create folder
4. Move item to folder

## Notes

* This step depends on a connected Canva integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Canva tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Canva as an Agent Tool

You can also add Canva as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Canva**. In the tool settings panel, choose the connected account the agent should use. The agent calls Canva actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.