# CloudConvert

CloudConvert is a file conversion service supporting over 200 formats, including audio, video, document, ebook, archive, image, spreadsheet, and presentation formats.

- **Category:** file management & storage
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `CLOUDCONVERT`
- **Version:** 20260309_00

## Tools

### Create Export Google Cloud Storage Task

**Slug:** `CLOUDCONVERT_CREATE_EXPORT_GOOGLE_CLOUD_STORAGE_TASK`

Tool to create a task to export files to a Google Cloud Storage bucket. Use after conversion when you need to store results directly into GCS. Ensure service account credentials have the proper permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | string | No | Filename/path for the exported file in the bucket. |
| `input` | string | Yes | The ID of the task to export. Multiple task IDs can be provided as a list. |
| `bucket` | string | Yes | The Google Cloud Storage bucket name. |
| `project_id` | string | Yes | The Google Cloud Project ID (`api-project-...`). |
| `file_prefix` | string | No | Prefix for exported files in the bucket when exporting multiple files. |
| `private_key` | string | Yes | The private key of the service account (PEM-encoded). |
| `client_email` | string | Yes | Service account client email (e.g., `my-sa@api-project-123456.iam.gserviceaccount.com`). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Export S3 Task

**Slug:** `CLOUDCONVERT_CREATE_EXPORT_S3_TASK`

Tool to create a task to export files to an Amazon S3 bucket. Use after conversion when you need to store results directly into S3. Ensure AWS credentials have s3:PutObject (and PutObjectAcl if using non-default ACL) permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `acl` | string ("private" | "public-read" | "public-read-write" | "authenticated-read" | "bucket-owner-read" | "bucket-owner-full-control") | No | S3 ACL for stored objects. Defaults to 'private'. |
| `key` | string | No | S3 object key (filename and path) for storing the file. Supports printf-style placeholders for multiple files, e.g., 'file-%d.pdf'. |
| `input` | string | Yes | The ID of the task to export, or a list of task IDs. |
| `bucket` | string | Yes | The Amazon S3 bucket where to store the file(s). |
| `region` | string | Yes | S3 region identifier (e.g., 'us-west-2' or 'eu-west-1'). |
| `tagging` | object | No | S3 object tags as key–value pairs. |
| `endpoint` | string | No | Custom S3 API endpoint URL. Overrides default built from region. Use for S3-compatible services. |
| `metadata` | object | No | Additional S3 metadata as key–value pairs (e.g., 'x-amz-meta-*'). |
| `key_prefix` | string | No | Prefix to prepend to the S3 object key when exporting multiple files. |
| `content_type` | string | No | Value for the 'Content-Type' header. Auto-detected if omitted. |
| `access_key_id` | string | Yes | AWS access key ID with `s3:PutObject` permission. |
| `cache_control` | string | No | Value for the 'Cache-Control' header (e.g., 'max-age=172800'). |
| `session_token` | string | No | AWS session token for temporary (STS) credentials. |
| `secret_access_key` | string | Yes | AWS secret access key. |
| `content_disposition` | string | No | Value for the 'Content-Disposition' header (e.g., 'attachment' or 'inline'). |
| `server_side_encryption` | string ("AES256" | "aws:kms") | No | Server-side encryption algorithm to use (AES256 or aws:kms). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Webhook

**Slug:** `CLOUDCONVERT_CREATE_WEBHOOK`

Creates a new webhook to receive CloudConvert event notifications. Use this when you need to be notified about job status changes (created, finished, or failed) via HTTP POST requests to your server.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The target URL where CloudConvert will send webhook notifications. Must be a publicly accessible HTTPS URL. |
| `event` | string | Yes | Event type to subscribe to. Valid values: 'job.created' (when a job is created), 'job.finished' (when a job completes successfully), 'job.failed' (when a job fails). |
| `payload` | object | No | Optional custom payload object to include in each webhook notification. Useful for passing context like user IDs or request identifiers. |
| `signing_secret` | string | No | Optional secret used to sign webhook payloads via HMAC-SHA256. Use this to verify that webhook requests originate from CloudConvert. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

**Slug:** `CLOUDCONVERT_DELETE_WEBHOOK`

Permanently delete a webhook by its ID. Use this when you no longer need to receive event notifications for a specific webhook. The webhook ID can be obtained from the create_webhook or list_webhooks actions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | The numeric ID of the webhook to delete. Obtain this from the create_webhook or list_webhooks actions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Operations

**Slug:** `CLOUDCONVERT_LIST_OPERATIONS`

Tool to list all possible CloudConvert operations with their available options and engine details. Use when you need to discover what operations are available, check operation requirements, or filter by input/output formats before creating tasks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include` | string | No | Comma-separated list of additional data to include. Options: 'options' (operation parameters), 'engine_versions' (available engine versions). |
| `filter_input_format` | string | No | Filter operations by input format. Only returns operations that accept this format as input. |
| `filter_output_format` | string | No | Filter operations by output format. Only returns operations that produce this format as output. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Supported Formats

**Slug:** `CLOUDCONVERT_LIST_SUPPORTED_FORMATS`

Tool to list all supported conversion formats, engines, and options. Use when you need to discover available conversions before creating tasks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include` | array | No | Include additional data: options and/or engine_versions. |
| `alternatives` | boolean | No | Set to true to include alternative conversion types. |
| `filter_engine` | string | No | Filter to include only conversions with this engine name. |
| `filter_input_format` | string | No | Filter to include only conversions with this input format. |
| `filter_output_format` | string | No | Filter to include only conversions with this output format. |
| `filter_engine_version` | string | No | Filter to include only conversions with this engine version. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tasks

**Slug:** `CLOUDCONVERT_LIST_TASKS`

List all CloudConvert tasks with their status, payload and results. Use this tool to: - Monitor conversion task progress and status - Find tasks by status (waiting, processing, finished, error) - Filter tasks by job ID to see all tasks in a specific job - Retrieve task results and output file URLs - Debug failed conversions by checking error codes and messages Tasks are automatically deleted 24 hours after completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (1-indexed). Use with per_page for pagination through large result sets. |
| `job_id` | string | No | Filter tasks by job ID. Only returns tasks belonging to the specified job. |
| `status` | string ("waiting" | "processing" | "finished" | "error") | No | Filter tasks by status: 'waiting' (queued), 'processing' (in progress), 'finished' (completed successfully), or 'error' (failed). |
| `include` | string | No | Comma-separated list of additional data to include in response. Options: 'retries' (retry tasks), 'depends_on_tasks' (task dependencies), 'payload' (submitted configuration). |
| `order_by` | string | No | Order results by a column with optional direction. Format: 'column_name [asc\|desc]'. Common columns: 'created_at', 'ended_at'. |
| `per_page` | integer | No | Number of tasks per page. Default is 100, maximum is 500. |
| `operation` | string | No | Filter tasks by operation type, e.g., 'convert', 'import/url', 'import/s3', 'export/url', 'export/s3'. |
| `created_at` | string | No | Filter tasks by creation datetime in ISO 8601 format. Supports comparison operators like [gte] for date ranges. |
| `completed_at` | string | No | Filter tasks by completion datetime in ISO 8601 format. Only applies to finished or error status tasks. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhooks

**Slug:** `CLOUDCONVERT_LIST_WEBHOOKS`

Tool to list all webhooks. Use when you need to retrieve existing webhooks before managing or inspecting them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to return (default: 1) |
| `per_page` | integer | No | Number of webhooks per page (default: 100) |
| `filter_url` | string | No | Filter results to webhooks with this URL |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Show User

**Slug:** `CLOUDCONVERT_SHOW_USER`

Retrieves the current authenticated user's CloudConvert account information. Returns the user's ID, username, email, remaining conversion credits, and account creation date. Requires the 'user.read' scope. Useful for verifying authentication and checking available credits.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
