Boomi connects Files.com to other applications, systems, and workflows through a visual, point-and-click interface. You can build integrations in a browser without writing code, and use them to automate your business tasks.

Getting Started With Boomi

Log in to your Boomi account or create a new Boomi account.
Navigate to "Services" then "Integration".
Select "Create New" then "Connection" and choose "Files.com - Partner Connector" from the list.
Use your Files.com API Key to connect your Files.com account to Boomi. Create a site-wide API Key for full access to all folders on your site without requiring a user account, or create an API Key for a specific user to restrict access to certain folders. See our documentation for creating API keys.

You can then create Boomi Processes to automate the transfer of data between your Boomi process and your Files.com account.

Documentation for the Files.com Partner Connector is on the Boomi Help site.

Files.com Partner Connector Configuration

The Files.com connector shape requires a Connection, an Action, and an Operation.

Connection

The Connection defines the Files.com account that performs the actions. It requires a Files.com API Key to authenticate and authorize the actions. Connections can be re-used in as many connector shapes as needed.

Ask your Files.com administrator to provide you with an API Key for the required user account, or generate your own API Key within your Files.com user account. The connection uses a single Files.com API Key.

When creating a new connection, go to the Connection tab, select the Click to Set button, enter the API Key, and select Apply.

Name the connection clearly, or provide a description, because the API Key does not show any identifying information and is stored in an encrypted state.

Connector Actions

The Action defines what the connector shape does on Files.com. The available actions are Copy, Create, Delete, Download, List, Move, Show, Update, Upload, List folder items (Deprecated), Download a file (Deprecated), and Upload a file (Deprecated).

The Copy action copies a file or folder in your Files.com site.

The Create action creates a folder, group, share link, share link notification, share link recipient, or user account in your Files.com site.

The Delete action deletes a file, folder, group, share link, share link notification, or user account from your Files.com site.

The Download action downloads a file's contents from Files.com into your Boomi process.

The List action lists items in your Files.com site. It can list the contents of a folder, all groups, all share links, all downloads of a share link, all share link notifications, all recipients of a share link, all registrations of a share link, and all user accounts.

The Move action moves or renames a file or folder in your Files.com site.

The Show action shows the details of a specific item in your Files.com site. It can show the details of a file, a folder, a group, a share link, a share link notification, or a user account.

The Update action updates an item in your Files.com site. It can update a group and its members, a share link's expiration date, a share link notification, and a user account.

The Upload action uploads data from your Boomi process, as a file, into a Files.com folder.

The Download a file action is deprecated and replaced by the Download action. It remains available for backwards compatibility, and downloads a file's contents from Files.com into your Boomi process.

The List folder items action is deprecated and replaced by the List action. It remains available for backwards compatibility. It lists the items contained within a Files.com folder, and its results can be used to traverse the folder structure, determine a file to download, or determine a target folder for a file upload.

The Upload a file action is deprecated and replaced by the Upload action. It remains available for backwards compatibility, and uploads data from your Boomi process, as a file, into a Files.com folder.

Connector Operations

The Operation defines a specific configuration for the chosen action, including the folder paths and file names. You can define as many operations as required, and reuse them across connector shapes.

See the Boomi Help documentation for details about configuring Connector Operations.

Automatic Retry Handling

The Boomi connector uses the official Files.com Java SDK, which provides built-in retry handling for all connector actions. When temporary network disruptions or transient service conditions occur, the SDK automatically retries the request before returning a failure.

This retry behavior applies to all actions, including file transfers and API operations. The retry logic operates internally and does not require configuration.

If the request continues to fail after 3 retry attempts, the connector surfaces the error to Boomi so your process can respond according to its configured error handling.

Connector Versions

The Files.com partner connector is updated as new features and fixes are applied.

New versions of the connector are made available 2 weeks before each runtime release window. Boomi's platform and runtime release schedule is at https://stats.boomi.com/.

Your running Boomi processes do not update automatically to new versions. To move to a newer or older version of the connector, update your Boomi process manually.

See the Boomi documentation for more information about how to manage Atom and Connector versions.