Transloadit

The Transloadit modules allow you to monitor and manage jobs, tasks, and import&export files in your Transloadit account.

Prerequisites

  • A Transloadit account

In order to use Transloadit with Integromat, it is necessary to have a Transloadit account. If you do not have one, you can create a Transloadit account at transloadit.com.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Transloadit to Integromat

To connect your Transloadit account to Integromat you need to obtain the Auth Secret and Auth Key from your Transloadit account and insert it in the Create a connection dialog in the Integromat module.

1. Log in to your Transloadit account and click Credentials

D4Phm2Sl6Q.gif

2. Copy the Auth Key and Auth Secret to a safe place.

transloadit1.png

3. Go to Integromat and open the Transloadit module's Create a connection dialog.

XDoZJRSpsV.gif

4. In the Connection name field, enter a name for the connection.

5. In the Secret and Key fields, enter the details copied in step 2 respective fields and click Continue.

The connection has been established.

Assemblies

See the Setting Up the Transloadit Webhooks to add webhooks in your Transloadit account.

Watch Finished Assembly

Triggers when a new assembly is finished.

Webhook Name Enter a name for the webhook.
Connection Establish a connection to your Transloadit account.

Watch Assembly Result

Triggers when an assembly with at least one result is finished.

Webhook Name Enter a name for the webhook.
Connection Establish a connection to your Transloadit account.

Watch Assemblies

Triggers when an assembly with at least one result is finished.

Connection Establish a connection to your Transloadit account.
Limit Set the maximum number of assemblies Integromat should return during one scenario execution cycle.

Search Assemblies

Lists assemblies.

Connection Establish a connection to your Transloadit account.
Limit Set the maximum number of assemblies Integromat should return during one scenario execution cycle.
The types of assemblies

Select the type of assemblies you are searching for:

  • All
  • Uploading
  • Executing
  • Canceled
  • Completed
  • Failed
  • Requested Aborted
From Date Enter the date to search the assemblies created on or after the specified date.
To Date Enter the date to search the assemblies created on or before the specified date.
Keywords Enter the keywords to search the assemblies that match the query.

Get an Assembly

Gets an assembly.

Connection Establish a connection to your Transloadit account.
The method of obtaining the status of the assembly

Select the option to choose the assembly whose details you want to retrieve:

  • Assembly ID
  • Assembly SSL URL
Assembly ID

Select the Assembly ID whose details you want to retrieve.

Assembly SSL URL

Enter the assembly SSL URL address which the machine details that controls the assembly whose details you want to retrieve.
When you create an assembly, you will see the field with the name Assembly SSL URL in the details.
transloadit2.png

Create an Assembly

Creates an assembly.

Connection Establish a connection to your Transloadit account.
The method of presenting the instructions of the assembly Select the option to create the assembly:
  • Template
  • Steps
Template ID Select the Template ID to create the assembly.
Steps Enter the steps or assembly instructions to process the files.  
Notify URL Enter the notification URL address. Transloadit can send a pingback to your server when the assembly is completed. The notification URL address sends the assembly status in JSON string inside a transloadit field in a multipart POST request to the URL supplied here.
Fields Add the custom fields and their value which can be used as Assembly Variables.
For example, to dynamically have resized images based on an end-user provided width, use ${fields.user_width} in your Assembly Instructions, and either post an <input name="user_width" value="800" /> or supply this fields param with the following object:
{
  "user_width": 800
}

Update an Assembly

Updates an assembly.

Connection Establish a connection to your Transloadit account.
Assembly URL Enter the assembly URL address whose details you want to update.
The method of presenting the instructions of the assembly Select the option to create the assembly:
  • Template
  • Steps
Template ID Select the Template ID which contains the assembly instructions.
Steps Enter the steps or assembly instructions to process the files.  
Notify URL Enter the notification URL address. Transloadit can send a pingback to your server when the assembly is completed. The notification URL address sends the assembly status in JSON string inside a Transloadit field in a multipart POST request to the URL supplied here.
Fields Add the custom fields and their value which can be used as Assembly Variables.
For example, to dynamically have resized images based on an end-user provided width, use ${fields.user_width} in your Encoding or Assembly Instructions, and either post an <input name="user_width" value="800" /> or supply this fields param with the following object:
{
  "user_width": 800
}
Reparse Template Select the reparsing template to update:
  • Reparse the identical steps used in the assembly
  • Reparse the template

Cancel a Running Assembly

Cancels an assembly (and upload if that is still in progress).

Assembly SSL URL Enter the assembly SSL URL address which the machine details that controls the assembly you want to cancel.
When you create an assembly, you will see the field with the name Assembly SSL URL in the details.
transloadit2.png

Other

See the Setting Up the Transloadit Webhooks to add webhooks in your Transloadit account.

Watch Image Face Detection

Triggers when an image face detection is complete.

Webhook Name Enter a name for the webhook.
Connection Establish a connection to your Transloadit account.

See the Setting Up the Transloadit Webhooks to add webhooks in your Transloadit account.

Watch WebM Conversion

Triggers when an iPad video optimization is completed.

Webhook Name Enter a name for the webhook.
Connection Establish a connection to your Transloadit account.

See the Setting Up the Transloadit Webhooks to add webhooks in your Transloadit account.

Watch iPad Video Optimization

Triggers when an iPad video optimization is complete.

Webhook Name Enter a name for the webhook.
Connection Establish a connection to your Transloadit account.

Detect Faces

Detects access in the image.

Connection Establish a connection to your Transloadit account.
Import Robot Select the option to import the files. For example, Import files from FTP Servers.
Import Credentials Enter the template credentials.
You must create your associated Template Credentials in your Transloadit account and use the name of your Template Credentials here.
They will contain the values for your FTP host, user, and password.
We recommend always using Template Credentials while some use cases demand dynamic credentials for which using Template Credentials with their static nature is too unwieldy. If you have this requirement, use the following parameters instead: hostuserpassword.
Import Paths Enter the path on your FTP server for searching the files.
The files are imported recursively from all sub-directories and sub-sub-directories (and so on) from this path.
Port Enter the port to use for the FTP connection. For example, 21.
Passive Mode Select whether if you want to use passive mode for the FTP connection.
Ignore Errors Add the error you want to ignore. For example, meta error, import errors.
Export Robot Select the option to export the files. For example, Export files from FTP Servers.
Crop Select whether the detected faces should be extracted. If you chose No, then the Robot returns the input image, but with the coordinates of all detected faces attached to file.meta.faces in the result JSON. If you chose Yes, the Robot will output all detected faces as images.
Faces Select the option to detect faces. In addition to the specified values, you can specify any integer number. The faces are sorted by their top-left corner and the integer determines the index of the returned face. Be aware the values are zero-indexed, meaning that faces: 0 will return the first face. If no face for a given index exists, no output is produced.
Minimum Confidence Enter the minimum confidence that a detected face must-have. The value must be number out of 100. 
Only faces that have a higher confidence value than this threshold will be included in the result.
Notify URL Enter the notification URL address. Transloadit can send a pingback to your server when the assembly is completed. The notification URL address sends the assembly status in JSON string inside a Transloadit field in a multipart POST request to the URL supplied here.
Fields Add the custom fields and their value which can be used as Assembly Variables.
For example, to dynamically have resized images based on an end-user provided width, use ${fields.user_width} in your Encoding or Assembly Instructions, and either post an <input name="user_width" value="800" /> or supply this fields param with the following object:
{
  "user_width": 800
}

Convert Video to WebM

Converts a video to WebM.

Connection Establish a connection to your Transloadit account.
Import Robot Select the option to import the files. For example, Import files from FTP Servers.
Import Credentials Enter the template credentials.
You must create your associated Template Credentials in your Transloadit account and use the name of your Template Credentials here.
They will contain the values for your FTP host, user, and password.
We recommend always using Template Credentials while some use cases demand dynamic credentials for which using Template Credentials with their static nature is too unwieldy. If you have this requirement, use the following parameters instead: hostuserpassword.
Import Paths Add the import paths. 
The path in your bucket to the specific file or directory.
If the path points to a file, only this file will be imported.
For example, js/my_javascript_file.js
If it points to a directory, then all files from this directory will be imported.
For example, js/.
For Transloadit to recognize you want to import all files from a directory, make sure your path ends with a / slash.
Directories are not imported recursively.
If you want to import all files from the root directory, use / as the value here.
In this case, ensure all your objects belong to a path.
If you have objects in the root of your bucket that isn't prefixed with /, you'll receive a 404 BACKBLAZE_IMPORT_NOT_FOUND error.
You can also use an array of path strings here to import multiple paths in the same Robot Step.
Recursive Select whether you want to enable importing files from subfolders of the given path.
Use the pagination parameters Start File Name and Files Per Page wisely here.
Ignore Errors Add the errors you want to ignore. For example, meta errorimport errors.
Export Robot Select the option to export the files. For example, Export files from FTP Servers.
Preset Select the option for a video according to pre-configured settings.
If you specify your own FFmpeg parameters using the Robot's and/or do not want Transloadit to set any encoding setting, starting ffmpeg_stack: v3.3.3, you can use the value empty here.
Width Enter the width of the input video in pixels.
Height Enter the height of the input video in pixels.
Resize Strategy

Select the resize strategy:

  • Fit - Uses the larger side of the original image as a base for the resize. The aspect ratio is preserved. Either side will become at most 100 pixels.
  • Fillcop - Scales the image to fit into our 100×100 target while preserving the aspect ratio, while trimming away any excess surface.
  • Min Fit - Uses the smaller side of the original image as a base for the resize. After resizing, the larger side will have a larger value than specified. The aspect ratio is preserved. Either side will become at least 100 pixels.
  • Pad - Scales the image to fit while preserving the aspect ratio. Both sides of the resized image become exactly 100 pixels, and any remaining surface is filled with a background color.
  • Stretch - Ignores aspect ratio, resizing the image to the exact width and height specified. This may result in a stretched or distorted image.
  • Crop - Cuts an area out of an image, discarding any overlapping parts. If the source image is smaller than the crop frame, it will be zoomed. This strategy is implied when you specify coordinates in the crop parameter, and cannot be used without it.
Background Enter the background color you want in the resulting video in the rgba format. For example, red, green, blue, alpha.
Zoom Select whether you want to zoom the videos. If selected No, smaller videos will not be stretched to the desired width and height.
Crop X1 Enter the coordinate for the upper left corner along the abscissa axis of the rectangle to be cropped.
Y1 Enter the coordinate for the upper left corner along the ordinate axis of the rectangle to be cropped.
X2 Enter the coordinate for the lower right corner along the abscissa axis of the rectangle to be cropped.
Y2 Enter the coordinate for the lower right corner along the ordinate axis of the rectangle to be cropped.
Rotate Enter the number in degrees for the video to be rotated by the specified degree integer. Currently, only multiples of 90 are supported.
Transloadit automatically corrects the orientation of many videos when the orientation is provided by the camera.
This option is only useful for videos requiring rotation because it was not detected by the camera. 
Hint Select whether you want to enable hinting for mp4 files, for RTP/RTSP streaming.
Turbo Select whether you want to speed up the encoding, especially for large non-adaptive workloads.
FFmpeg Stack
Selects the FFmpeg stack version to use for encoding.
FFmpeg

Add the parameter object to be passed to FFmpeg.
For available options, see the FFmpeg documentation.

If a preset is used, the options specified are merged on top of the ones from the preset. The FFmpeg r parameter (framerate) has a default value of 25 and a maximum value of 60.

If you set r to null, you clear the default of 25 and can preserve the original video's framerate.

Watermark URL Enter the URL address for the watermark image that will be overlaid above this image. Choose the image in PNG format.
Watermark Position

Select the watermark position. For example, center, bottom, bottom-right.

Watermark X Offset Enter the number of pixels for X-offset at which the watermark will be placed in relation to the position it has due to the Watermark Position. Values can be both positive and negative and yield different results depending on the Watermark Position parameter. Positive values move the watermark closer to the image's center point, whereas negative values move the watermark further away from the image's center point.
Watermark Y Offset

Enter the number of pixels for y-offset at which the watermark will be placed in relation to the position it has due to Watermark Position.

Values can be both positive and negative and yield different results depending on the Watermark Position parameter.

Positive values move the watermark closer to the image's center point, whereas negative values move the watermark further away from the image's center point.

Watermark Size

Enter the size of the watermark as a percentage. For example, 50%. The watermark resize depends on the Watermark Resize Strategy.

Watermark Resize Strategy

Select the option for watermark resizing:

  • Fit - The watermark is scaled so that the longer side of the watermark takes up 25% of the corresponding video side. And the other side is scaled according to the aspect ratio of the watermark image
  • Stretch - The watermark image is stretched (meaning, it is resized without keeping its aspect ratio in mind) so that both sides take up 25% of the corresponding video side.
  • Area - The watermark is resized (keeping its aspect ratio in check) so that it covers xx% of the video's surface area. The value from watermark_size is used for the percentage area size.

For example, our target video size is 800×800 pixels and our watermark image is 400×300 pixels. Let's also assume, the watermark_size parameter is set to 25%.

If you select the Fit option with our watermark, the width is the longer side, and 25% of the video size would be 200px. Hence, the watermark would be resized to 200×150 pixels. If the watermark_size was set to 50%, it would be resized to 400×300 pixels (so just left at its original size).

If you select the Stretch, since our video is 800×800 pixels, for a watermark size of 25% the watermark would be resized to 200×200 pixels. Its height would appear stretched as it would be resized to 200×150 pixels keeping the aspect ratio in mind.

If you select the Area option, the value from watermark_size is used for the percentage area size.

Watermark Start Time Enter the delay in seconds from the start of the video for the watermark to appear. By default, the watermark is immediately shown.
Watermark Duration Enter the duration in seconds for the watermark to be shown. Can be used together with watermark_start_time to create nice effects. The default value is -1.0, which means that the watermark is shown for the entire duration of the video.
Watermark Opacity
Enter the opacity of the watermark. Valid values are between 0 (invisible) and 1.0 (full visibility). Enter a value between 0 and 1.
Notify URL Enter the notification URL address. Transloadit can send a pingback to your server when the assembly is completed. The notification URL address sends the assembly status in JSON string inside a Transloadit field in a multipart POST request to the URL supplied here.
Fields Add the custom fields and their value which can be used as Assembly Variables.
For example, to dynamically have resized images based on an end-user provided width, use ${fields.user_width} in your Encoding or Assembly Instructions, and either post an <input name="user_width" value="800" /> or supply this fields param with the following object:
{
  "user_width": 800
}

Optimize a Video

Optimizes a video for iPad.

Connection Establish a connection to your Transloadit account.
Import Robot Select the option to import the files and enter the details. For example, Import files from FTP Servers.
Import Credentials Enter the template credentials.
You must create your associated Template Credentials in your Transloadit account and use the name of your Template Credentials here.
They will contain the values for your FTP host, user, and password.
We recommend always using Template Credentials while some use cases demand dynamic credentials for which using Template Credentials with their static nature is too unwieldy. If you have this requirement, use the following parameters instead: hostuserpassword.
Import Paths Add the import paths. 
The path in your bucket to the specific file or directory.
If the path points to a file, only this file will be imported.
For example, js/my_javascript_file.js
If it points to a directory, then all files from this directory will be imported.
For example, js/.
For Transloadit to recognize you want to import all files from a directory, make sure your path ends with a / slash.
Directories are not imported recursively.
If you want to import all files from the root directory, use / as the value here.
In this case, ensure all your objects belong to a path.
If you have objects in the root of your bucket that isn't prefixed with /, you'll receive a 404 BACKBLAZE_IMPORT_NOT_FOUND error.
You can also use an array of path strings here to import multiple paths in the same Robot Step.
Recursive Select whether you want to enable importing files from subfolders and subfolders, etc. of the given path.
Use the pagination parameters Start File Name and Files Per Page wisely here.
Ignore Errors Add the errors you want to ignore. For example, meta errorimport errors.
Export Robot Select the option to export the files and enter the details. For example, Export files from FTP Servers.
Preset Select the option for a video according to pre-configured settings.
If you specify your own FFmpeg parameters using the Robot's and/or do not want Transloadit to set any encoding setting, starting ffmpeg_stack: v3.3.3, you can use the value empty here.
Width Enter the width of the input video in pixels.
Height Enter the height of the input video in pixels.
Resize Strategy

Select the resize strategy:

  • Fit - Uses the larger side of the original image as a base for the resize. The aspect ratio is preserved. Either side will become at most 100 pixels.
  • Fillcop - Scales the image to fit into our 100×100 target while preserving the aspect ratio, while trimming away any excess surface.
  • Min Fit - Uses the smaller side of the original image as a base for the resize. After resizing, the larger side will have a larger value than specified. The aspect ratio is preserved. Either side will become at least 100 pixels.
  • Pad - Scales the image to fit while preserving the aspect ratio. Both sides of the resized image become exactly 100 pixels, and any remaining surface is filled with a background color.
  • Stretch - Ignores aspect ratio, resizing the image to the exact width and height specified. This may result in a stretched or distorted image.
  • Crop - Cuts an area out of an image, discarding any overlapping parts. If the source image is smaller than the crop frame, it will be zoomed. This strategy is implied when you specify coordinates in the crop parameter, and cannot be used without it.
Background Enter the background color you want in the resulting video in the rgba format (red, green, blue, alpha).
Zoom Select whether you want to zoom the videos. If selected No, smaller videos will not be stretched to the desired width and height.
Crop X1 Enter the coordinate for the upper left corner along the abscissa axis of the rectangle to be cropped.
Y1 Enter the coordinate for the upper left corner along the ordinate axis of the rectangle to be cropped.
X2 Enter the coordinate for the lower right corner along the abscissa axis of the rectangle to be cropped.
Y2 Enter the coordinate for the lower right corner along the ordinate axis of the rectangle to be cropped.
Rotate Enter the number in degrees for the video to be rotated by the specified degree integer. Currently, only multiples of 90 are supported.
Transloadit automatically corrects the orientation of many videos when the orientation is provided by the camera.
This option is only useful for videos requiring rotation because it was not detected by the camera. 
Hint Select whether you want to enable hinting for mp4 files, for RTP/RTSP streaming.
Turbo Select whether you want to speed up the encoding, especially for large non-adaptive workloads.
FFmpeg Stack
Selects the FFmpeg stack version to use for encoding.
FFmpeg

Add the parameter object to be passed to FFmpeg.
For available options, see the FFmpeg documentation.

If a preset is used, the options specified are merged on top of the ones from the preset. The FFmpeg r parameter (framerate) has a default value of 25 and a maximum value of 60.

If you set r to null, you clear the default of 25 and can preserve the original video's framerate.

Watermark URL Enter the URL address for the watermark image that will be overlaid above this image. Choose the image in PNG format.
Watermark Position

Select the watermark position. For example, center, bottom, bottom-right.

Watermark X Offset Enter the number of pixels for X-offset at which the watermark will be placed in relation to the position it has due to Watermark Position. Values can be both positive and negative and yield different results depending on the Watermark Position parameter. Positive values move the watermark closer to the image's center point, whereas negative values move the watermark further away from the image's center point.
Watermark Y Offset

Enter the number of pixels for y-offset at which the watermark will be placed in relation to the position it has due to Watermark Position.

Values can be both positive and negative and yield different results depending on the Watermark Position parameter.

Positive values move the watermark closer to the image's center point, whereas negative values move the watermark further away from the image's center point.

Watermark Size

Enter the size of the watermark as a percentage. For example, 50%. The watermark resize depends on the Watermark Resize Strategy.

Watermark Resize Strategy

Select the option for watermark resizing:

  • Fit - The watermark is scaled so that the longer side of the watermark takes up 25% of the corresponding video side. And the other side is scaled according to the aspect ratio of the watermark image
  • Stretch - The watermark image is stretched (meaning, it is resized without keeping its aspect ratio in mind) so that both sides take up 25% of the corresponding video side.
  • Area - The watermark is resized (keeping its aspect ratio in check) so that it covers xx% of the video's surface area. The value from watermark_size is used for the percentage area size.

For example, our target video size is 800×800 pixels and our watermark image is 400×300 pixels. Let's assume, the watermark_size parameter is set to 25%.

If you select Fit option with our watermark, the width is the longer side, and 25% of the video size would be 200px. Hence, the watermark would be resized to 200×150 pixels. If the watermark_size was set to 50%, it would be resized to 400×300 pixels (so just left at its original size).

If you select Stretch, since our video is 800×800 pixels, for a watermark size of 25% the watermark would be resized to 200×200 pixels. Its height would appear stretched as it would be resized to 200×150 pixels keeping the aspect ratio in mind.

If you select the Area option, the value from watermark_size is used for the percentage area size.

Watermark Start Time Enter the delay in seconds from the start of the video for the watermark to appear. By default, the watermark is immediately shown.
Watermark Duration Enter the duration in seconds for the watermark to be shown. Can be used together with watermark_start_time to create nice effects. The default value is -1.0, which means that the watermark is shown for the entire duration of the video.
Watermark Opacity
Enter the opacity of the watermark. Valid values are between 0 (invisible) and 1.0 (full visibility). Enter a value between 0 and 1.
Notify URL Enter the notification URL address. Transloadit can send a pingback to your server when the assembly is completed. The notification URL address sends the assembly status in JSON string inside a Transloadit field in a multipart POST request to the URL supplied here.
Fields Add the custom fields and their value which can be used as Assembly Variables.
For example, to dynamically have resized images based on an end-user provided width, use ${fields.user_width} in your Encoding or Assembly Instructions, and either post an <input name="user_width" value="800" /> or supply this fields param with the following object:
{
  "user_width": 800
}

Make an API Call

Performs an arbitrary authorized API call.

Connection Establish a connection to your Transloadit account.
URL

Enter a path relative to https://api2.transloadit.com/. For example: /assemblies

For the list of available endpoints, refer to the Transloadit API 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.

Setting Up the Transloadit Webhooks

1. Open any Watch module, establish a connection, click Save and copy the URL address to your clipboard. Click OK and save the trigger.

igBeA3nwut.gif

2. Log in to your Transloadit account.

3. Select the assembly for which you want to receive the triggers.

4. In the New Notify URL  field, enter the URL address copied in step 1 and click Send Notification.

rzRdAgBLyd.gif

You have successfully added the webhooks.

Popular use cases from our blog

slack-automation-illustration

Slack Automation: 20 Free Templates to Get You Inspired

google-sheets-automation-alt

Google Sheets Automation for Ecommerce: 23 Free Templates

tweet-automation-illustration

How to Get Someone's Tweets Before Anyone Else Does

onboarding-automation-with-integromat-alt

How to Automate Employee Onboarding in Minutes with Integromat

shopify-order-to-manufacturer-illustration-alt

How to Auto Send Shopify Orders to Dropshipping Suppliers [Guide]

strava-exercise-to-google-sheets-illustration

Like a Champ: How to Save Strava Activities to Google Sheets

Didn’t find what you were looking for?

Ticket

Create a ticket

Contact our world-class support team and tell us what’s happening.

Create a ticket
Expert

Find an expert

We feature a network of 450+ certified partners across the globe who are ready to help

Find an expert

Automate any workflow in your business

Sign up for a free account today. No credit card required, no time limits on free plan.