Overview
CloudConvert is a file-format conversion service supporting 200+ formats – documents, spreadsheets, images, audio, video. The Automize CloudConvert connector wraps their job-based async API for conversions.
- Regions: CloudConvert is global. EU data residency available for paying customers.
- Plans: Free tier (limited daily conversions) + tiered paid plans by minutes/month.
Setting up the connection
Auth type: Bearer Token.
- Sign in to cloudconvert.com → Dashboard → API → API Keys → Create.
- Pick scopes (user.read, user.write, task.read, task.write).
- Copy the token (JWT format).
- In Automize, open Settings → Connectors → CloudConvert → Add connection. Paste the token.
Find your credentials at https://cloudconvert.com/dashboard/api/v2/keys.
Rate limits
Per-minute rate limits + concurrent conversions cap. Bigger plans get more concurrency. Connector retries 429 with backoff.
Data model
Job + tasks model:
Job ─── Tasks (each task is one operation):
├─ import (load file from URL/upload/storage)
├─ convert (transform format)
└─ export (provide download URL)
Most workflows = one import + one convert + one export, chained.Available operations
8 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Create Job | General | Create a conversion job with tasks |
| Create Task | General | Create an individual conversion task |
| Export to URL | General | Get a download URL for a converted file |
| Get Job | General | Get job status and results |
| Get Task | General | Get task status |
| Import from URL | General | Import a file from a URL for conversion |
| List Jobs | General | List recent jobs |
| Upload File | General | Upload a file for conversion |
Operations
Create Job
Create a conversion job with tasks
| Parameter | Required | Type | Description |
|---|---|---|---|
Tasks tasks | Yes | text | |
Tag tag | Yes | text |
Tips
- tasks: object of named tasks. Each links to others via input.
- Example: {tasks: {import:{operation:'import/url', url:'...'}, convert:{operation:'convert', input:'import', input_format:'docx', output_format:'pdf'}, export:{operation:'export/url', input:'convert'}}}.
- Submit the job, then poll Get Job until status=finished.
Create Task
Create an individual conversion task
| Parameter | Required | Type | Description |
|---|---|---|---|
Input input | Yes | text | |
Input Format input_format | Yes | text | |
Output Format output_format | Yes | text | |
Filename filename | Yes | text |
Tips
- Standalone task – for fine-grained workflows. Most users prefer Create Job (atomic, easier).
Export to URL
Get a download URL for a converted file
| Parameter | Required | Type | Description |
|---|---|---|---|
Input input | Yes | text |
Tips
- Returns short-lived download URL for the converted result.
Get Job
Get job status and results
| Parameter | Required | Type | Description |
|---|---|---|---|
Job Id job_id | Yes | text |
Tips
- Returns job status (waiting, processing, finished, error) + per-task status.
- Poll every 2-5 sec for typical conversions.
Get Task
Get task status
| Parameter | Required | Type | Description |
|---|---|---|---|
Task Id task_id | Yes | text |
Tips
- Individual task status. Useful when debugging a stuck job.
Import from URL
Import a file from a URL for conversion
| Parameter | Required | Type | Description |
|---|---|---|---|
Url url | Yes | text | |
Filename filename | Yes | text |
Tips
- Fetches a file from a public URL. Returns task_id used as input by subsequent convert task.
List Jobs
List recent jobs
No input parameters.
Tips
- Recent jobs. Filter by status, tag (a custom identifier you set on Create Job).
Upload File
Upload a file for conversion
No input parameters.
Tips
- Two-step: create upload task → returns upload URL. PUT bytes there.
FAQ
- Conversion options for a format?
- Pass conversion-specific options on the convert task – engine (libreoffice, pandoc), pdf_a, dpi, etc. See CloudConvert format docs.
- Sync conversion possible?
- Not strictly – but if you set wait=true on Create Job, the API holds the response until done (up to ~5 min). For long jobs use real polling.
- Storage integrations?
- CloudConvert can pull from / push to S3, Azure Blob, Google Drive, etc. via storage tasks. Configure storage credentials in CloudConvert dashboard.