File and Document Management
CloudConvert
CloudConvert modules
11 min
after connecting to the cloudconvert app, you can use the following modules to build your {{scenario plural lowercase}} common tasks convert a file converts a specified file to the selected file format connection cloudconvert docid 0jp6s7 zhsppd osxb gu input file select whether you want to upload a file using make or provide the url the file will be uploaded from upload a file enter the source file by adding the file name and file data manually or by mapping the file from a previous module e g dropbox > get a file data enter or map the file data file name enter the file name including the file extension e g test txt import a file from url url enter the url of the file you want to convert headers define request headers (optional) useful, for example, when the specified url requires the authorization format select whether you want to specify the input format of the file you want to convert if not specified, the extension of the input file is used as the input format input format select the current format of the file output format select the target file format you want to convert the file to file name choose a filename (including extension) for the target output file conversion and engine specific options specify conversion and engine specific options to view available options, please visit their api documentation https //cloudconvert com/api/v2/convert#convert tasks and select the input format and output format download a file enable this option to include also file data in the module's output capture a website captures a specified website and saves it in pdf, jpg, or png format connection cloudconvert docid 0jp6s7 zhsppd osxb gu url enter the url of the website you want to capture output format select whether you want to save the captured website in png, jpg, or pdf format file name enter a filename (including extension) for the target output file headers define request headers (optional) useful, for example, when the specified url requires the authorization conversion and engine specific options specify conversion and engine specific options to view available options, please visit their api documentation https //cloudconvert com/api/v2/capture website#capture website tasks and select the input format and output format download a file enable this option to include also file data in the module's output optimize a file optimizes and compresses a file currently supported formats are pdf, png and jpg connection cloudconvert docid 0jp6s7 zhsppd osxb gu input file select whether you want to upload a file using make or provide the url the file will be uploaded from upload a file enter the source file by adding the file name and file data manually or by mapping the file from a previous module e g dropbox > get a file data enter or map the file data file name enter the file name including the file extension e g test txt import a file from url url enter the url of the file you want to optimize headers define request headers (optional) useful, for example, when the specified url requires the authorization optimization for select the optimization profile for specific target needs web optimization for the web ( default ) remove redundant and unnecessary data for the web down sample, clip, and intelligently compress images merge and subset fonts convert colors to rgb print optimization for print remove redundant and unnecessary data for printing down sample, clip, and intelligently compress images merge and subset fonts convert colors to cmyk archive optimization for archiving purposes remove redundant and unnecessary data for archiving intelligently compress images merge and subset fonts scanned images optimization for scanned images profile optimized for pdfs that mainly consist of raster images compress the images without significantly reducing the visual quality maximal size reduction optimization for maximal size reduction use the maximal possible compression might reduce the visual quality input format select the format of the input file you want to optimize file name enter the file name (including extension) for the target output file conversion and engine specific options specify conversion and engine specific options to view available options, please visit their api documentation https //cloudconvert com/api/v2/optimize#optimize tasks and select the output format download a file enable this option to include also file data in the module's output create an archive enables you to add one or multiple files to the zip, rar, 7z, tar, tar gz or tar bz2 archive connection cloudconvert docid 0jp6s7 zhsppd osxb gu input files specify files you want to add to the archive upload a file enter the source file by adding the file name and file data manually or by mapping the file from a previous module e g dropbox > get a file data enter or map the file data file name enter the file name including the file extension e g test txt import a file from url url enter the url of the file you want to archive headers define request headers (optional) useful, for example, when the specified url requires the authorization output format select the target format of the archived file file name enter the file name (including extension) for the target output file conversion and engine specific options specify conversion and engine specific options to view available options, please visit their api documentation https //cloudconvert com/api/v2/archive#archive tasks and select the output format download a file enable this option to include also file data in the module's output merge files merges at least two files into one pdf if input files are not pdfs yet, they are automatically converted to pdf connection cloudconvert docid 0jp6s7 zhsppd osxb gu input files specify files you want to add to the archive upload a file enter the source file by adding the file name and file data manually or by mapping the file from a previous module e g dropbox > get a file data enter or map the file data file name enter the file name including the file extension e g test txt import a file from url url enter the url of the file you want to archive headers define request headers (optional) useful, for example, when the specified url requires the authorization output format select the target format file name enter the file name (including extension) for the target output file conversion and engine specific options specify conversion and engine specific options to view available options, please visit their api documentation https //cloudconvert com/api/v2/merge#merge tasks and select the output format download a file enable this option to include also file data in the module's output jobs new job event triggers when the job or task docid\ njua2q fysjcuxfnuplza is created , has finished , or has failed in your account the job created by the create a job (advanced) module consists of several tasks the new job event trigger is also triggered when an individual task docid\ njua2q fysjcuxfnuplza is created, has finished, or has failed webhhook name enter the webhook name e g document conversion finished connection cloudconvert docid 0jp6s7 zhsppd osxb gu event select whether the module is triggered when the job/task is created, has finished, or has failed create a job (advanced) this module performs a job (a job can be one or multiple tasks that are identified in the name field and linked between each other using the input field) for further processing of the finished job created with the create a job module, please use the docid\ njua2q fysjcuxfnuplza ( job finished ) module in another scenario connection cloudconvert docid 0jp6s7 zhsppd osxb gu input files add the files you want to use within the job upload a file enter the source file by adding the file name and file data manually or by mapping the file from a previous module e g dropbox > get a file data enter or map the file data file name enter the file name including the file extension e g test txt import a file from url url enter the url of the file you want to process headers define request headers (optional) useful, for example, when the specified url requires the authorization tasks add tasks that will be performed within the job please find the descriptions of the operations' fields in the corresponding section convert a file https //www make com/en/help/apps/file and document management/cloudconvert html#convert a file 968217 capture a website https //www make com/en/help/apps/file and document management/cloudconvert html#capture a website optimize a file https //www make com/en/help/apps/file and document management/cloudconvert html#optimize a file merge files https //www make com/en/help/apps/file and document management/cloudconvert html#merge files create archives https //www make com/en/help/apps/file and document management/cloudconvert html#create an archive 968217 execute a command ( cloudconvert api documentation ) export a file to temporary url (specify the task name and input task name (e g conversion )) tag an arbitrary string to identify the job does not have any effect and can be used to associate the job with an id if working with the array aggregator (e g you have many files in different formats to convert), use the i don't know the input format option in the add a task dialog otherwise the error is returned linking tasks within the job ( name > input , name > input , ) list jobs retrieves all jobs that have been run in your account connection cloudconvert docid 0jp6s7 zhsppd osxb gu status select the job status to filter returned jobs by limit set the number of returned jobs make will return during one execution cycle get a job retrieves job details connection cloudconvert docid 0jp6s7 zhsppd osxb gu job id enter (map) the id of the job you want to retrieve details about delete a job deletes a job, including all tasks and data jobs are deleted automatically 24 hours after they have ended connection cloudconvert docid 0jp6s7 zhsppd osxb gu job id enter (map) the id of the job you want to delete tasks get a task retrieves task details connection cloudconvert docid 0jp6s7 zhsppd osxb gu task id enter (map) the id of the task you want to retrieve details about download a file retrieves file name and file data from the specified task connection cloudconvert docid 0jp6s7 zhsppd osxb gu task id enter (map) the id of the task you want to download the file from list tasks retrieves all tasks in your account based on filter settings connection cloudconvert docid 0jp6s7 zhsppd osxb gu status select the task status to filter returned tasks by job id enter (map) the job id to return only tasks within the specified job operation enter the operation type to return only tasks with the specified operation use the list possible operations module to retrieve operations limit set the number of returned tasks make will return during one execution cycle retry a task creates a new task, based on the settings (payload) of another task connection cloudconvert docid 0jp6s7 zhsppd osxb gu task id enter (map) the id of the task you want to create a new task from cancel task cancels a task that has a status of waiting or processing connection cloudconvert docid 0jp6s7 zhsppd osxb gu task id enter (map) the id of the task you want to cancel delete a task delete a task, including all data tasks are deleted automatically 24 hours after they have ended connection cloudconvert docid 0jp6s7 zhsppd osxb gu task id enter (map) the id of the task you want to delete other get my info retrieves authenticated account details (including credits remaining conversion minutes) make an api call allows you to perform a custom api call connection cloudconvert docid 0jp6s7 zhsppd osxb gu url enter a path relative to https //api cloudconvert com/ for example /v2/tasks for the list of available endpoints, refer to the cloudconvert api v2 documentation method select the http method you want to use get to retrieve information for an entry post to create a new entry put to update/replace an existing entry patch to make a partial entry update delete to delete an entry headers enter the desired request headers you don't have to add authorization headers; we already did that for you query string enter the request query string body enter the body content for your api call example of use list tasks the following api call returns all tasks from your cloudfront account url /v2/tasks method get matches of the search can be found in the module's output under bundle > body > data in our example, 6 tasks were returned