Getting Started

Most Couchdrop users are interested in one core feature of Couchdrop

Common Questions

Couchdrop acts as an SFTP server out of the box and supports thousands of users in a single tenant and Petabytes of data through our cloud storage integrations.

Introduction to SFTP

Secure File Transfer Protocol (SFTP) is a secure and reliable method of transferring files between systems over a network. Unlike traditional FTP, which sends data in plain text, SFTP encrypts both authentication credentials and file data using the Secure Shell (SSH) protocol. This ensures that sensitive information remains protected during transit.

SFTP in Couchdrop

Couchdrop gives you SFTP without the servers. In minutes, you can spin up secure, cloud-hosted SFTP endpoints that connect directly to your existing storage like Dropbox, Google Drive, OneDrive, or S3. Your partners still use SFTP exactly as they always have — but you get cloud-native flexibility, enterprise-grade security, and zero infrastructure to manage. It’s the simplest way to modernize SFTP

Getting Started with Couchdrop

Inbound SFTP is enabled by default in Couchdrop accounts - but you will need to configure SFTP users for access.

Accessing Couchdrop via SFTP requires a user account. Inbound SFTP users are independent from Administrators in Couchdrop and are designed to have limited access.

We do not recommend using your owner account as they have elevated permissions to Couchdrop and generally SFTP users are shared with external systems and providers.

User Management in Couchdrop

Creating a new User

Creating a new Inbound SFTP user is done in the management dashboard from Couchdrop and is a simple two step process.

Requirements

To create a new user - you will need:

• A username and password - the username needs to be unique in Couchdrop.

• A folder location where that user will be isolated to.

• Administrator access to your Couchdrop tenant

Configuration Steps

Login to Couchdrop at -

1. From the dashboard - click "+ Create" and then choose SFTP User

2. Follow the wizard to create your new user

3. Share the newly created user with your end customer

You can see who has access directly in the Couchdrop SFTP section from the web app.

Couchdrop acts as an FTP and FTPs server out of the box.

Introduction to FTP

File Transfer Protocol (FTP) is one of the oldest methods of moving files between computers over a network. It uses a client-server model where users connect to an FTP server to upload, download, or manage files.

While simple and widely supported, traditional FTP sends data - including usernames and passwords - in plain text, making it insecure by modern standards.

Unlike SFTP, FTP is disabled by default in Couchdrop. This is because FTP is comparitively buggy and insecure and so we do not recommend using it where there are other options.

Enabling FTPs

To enable FTPs access, you must be an administrator or the owner in Couchdrop.

• Login to Couchdrop's web app

• Click SFTP Server

• Click FTP Connectivity

• Click Enable FTP

This setting will activate immediately.

Account expiry in Couchdrop is a useful tool for ensuring that accounts are short lived.

Any account except the owner can be configured with an expiry. When an account has expired, all access with be disabled.

Couchdrop provides a public host key that can be used to verify the authenticity of the endpoint you are connecting to. This key is static and we do not expect it to change in the future.

The host key for all Couchdrop endpoints

AAAAB3NzaC1yc2EAAAADAQABAAAAgQCFzDO6AiZhK4ks4Bz/VBysjB3fpExCfOmy2EuI2gXJDYgom4nvZK4eEEgHRrkNoRUww4RJ7CTRKKXWodP7OthQw2AfppgBfR8dUK3zYdp/IClqTZ0+yxk72lLV9k8HwbtalOEzlJNc6AKlAkDi+WtG8RRZbJeaQZf3pe0k6oa7yQ==

The Windows agent has a collection of logfiles that can be useful for debugging issues. Our support team might also ask for them from time to time.

You can find the default location for the logs here:

C:\Users\%username%\AppData\Local\CouchdropCloudConnector

You can also jump directly to the local logs and configuration file within the settings (gear) within the Couchdrop agent.

Most failures or issues with automations tend to come down to configuration or connectivity issues. To make things easy, every transfer automation attempt has a verbose automation log. You can review the logs at Automations > [Automation Name] > View Executions and choosing a specific execution time.

Failures will be noted with a red dot for easy identification.

Introduction

Connecting to Box is fast to set up and fully supported in Couchdrop.

Requirements

To connect to Box in Couchdrop you will need:

• A licensed Box account

• Access as a Team Admin (if connecting to other Box users in the organization)

Configuration Steps

1. Log in to Couchdrop and add a new storage connection

2. Provide a name for the connection. This is how the Box connection will appear in Couchdrop

3. Select Box from the list of available connections

Introduction

Connecting Couchdrop to an Amazon S3 bucket is done using an IAM keyset. It can be completed in a few minutes if you have the right access in AWS.

Requirements

To connect to Amazon S3 in Couchdrop you will need:

• An S3 Bucket already configured

• An AWS IAM Key

• An AWS IAM Secret

• The AWS region

Configuration Steps

1. Log in to Couchdrop and add a new storage connection

2. Select Amazon S3 from the list of available connections

3. Provide the details above

Introduction

Connecting to Azure Files online is fast to set up and fully supported in Couchdrop.

Requirements

To connect to Azure Files online in Couchdrop you will need:

• Azure Account Name

• Azure Secret Key

• Azure Share Name

To learn how to configure Azure - you can visit

Configuration Steps

1. Log in to Couchdrop and add a new storage connection

2. Select Azure Files from the list of available connections

3. Provide your account name, secret and share name.

Introduction

Couchdrop can be connected to a Google Drive folder in a few simple steps. Couchdrop works with Personal Google Drive accounts and Google Workspaces.

Requirements

To connect to Google Drive online in Couchdrop you will need:

• A licensed Google Drive Account

• A folder in Google Drive

Configuration Steps

1. Log in to Couchdrop and add a new storage connection

2. Select Google Drive Personal from the list of available connections

3. Click Connect to Google.

Overview and Introduction

Couchdrop is not a fileserver - but it has some traits of one. Everything in Couchdrop starts as a folder. But folders themselves are abstract and do not necessarily live inside Couchdrop.

When you connect Couchdrop to Sharepoint or any one of the other over 50 platforms we support - you provide a folder name. This folder name acts as a filesystem location in Couchdrop.

Browsing that folder in the filesystem will not show the contents of Couchdrop - rather the files and folders that live in that external platform.

Uploading a file to that folder - via any means - will result in Couchdrop transferring the file to that provider or platform rather than the file living in Couchdrop.

Thus - to send a file to an external SFTP provider - you would simply upload it to the right folder inside Couchdrop.

Requirements

Required Configuration

To setup a Webhook you will need:

• Webhook Endpoint

• Event JSON attribute

Optional Configuration

You can configure these optional attributes

• Additional Headers for e.g. basic authentication

• Additional Attributes that are part of the json object we send to your logging system

Configuration Steps

1. Log in to Couchdrop and navigate to the Admin Panel - Logging

2. Select Connect/Manage on the Webhook Provider Pill

3. Select the Events to send via the Webhook

Introduction

Traditional SFTP and FTP servers use local storage and most cloud hosted SFTP servers provide some level of storage. Couchdrop is a bit different in this regard. Rather than including storage that is on disk, Couchdrop connects to your storage platform.

We support over 30 different cloud storage engines, including:

Introduction

Couchdrop can be connected to a Google Workspace by creating a service account, which Couchdrop can do for you automatically. Couchdrop works with both Personal Google Drive accounts and Google Workspace accounts.

Introduction

File action workflows activate when a particular trigger condition is met. This trigger is configured as the first action of a File Action workflow.

Introduction

Couchdrop supports Microsoft Windows and Apple OSX using a lightweight agent that is installed directly on the file server, another server, or on a virtual machine.

The agent uses a shared token for authentication and communicates with Couchdrop's infrastructure via secure HTTPS calls. The agent can be run in a standalone fashion or .

Introduction

File Actions allow certain actions to occur when a file is uploaded or downloaded to Couchdrop. These can be connected to other ingestion and sharing methods including Mailboxes, Shared Links, AS2 Stations, and SFTP uploads and downloads.

File Actions are built using the .

Introduction

Connecting to Egnyte is fast to set up and fully supported in Couchdrop.

Requirements

Couchdrop automations are built using a visual builder that requires no code. The builder supports multiple steps through primary actions and sub-actions.

How the builder works

Automations have two main pathways. Moving down the tree are primary actions. Moving to the right are sub-actions.

See the sample image below of an automation created with the visual builder.

Introduction

Connecting to Dropbox is fast to set up and fully supported in Couchdrop. Couchdrop can connect to both Dropbox Personal and Dropbox Business accounts.

The Couchdrop Agent (Couchdrop Cloud Connector) can be run as a Windows service.

Installing the agent as a service requires some understanding of how Windows services work and the service must be configured to run as the same user that is performing the configuration.

Before starting, make sure that you have installed the Couchdrop Cloud Connector by Make sure you have run and configured everything properly and check that it is working. We recommend closing the desktop configuration app and systray application before starting the service.

Next in a command line, open the Couchdrop Cloud Connector folder located under Program Files and run the following command.

Next, open the service manager:

Find the service for "Couchdrop Cloud Connector" and open it.

Connecting to Couchdrop with a FTP client is simple. To get started, you will need:

• A username and password or

• A username and key

Managing Users In Couchdrop

User management in Couchdrop is done under Administration --> Users or under the Users section from the main navigation.

Overview

System integrations allow you to connect a system that Couchdrop can use to stream data into.

These differ from storage integrations, as storage integrations are external file systems, and platforms are external system we stream data into, such as databases or queues.

Outside of the standard user roles, access to various features can be managed on an individual user and a group basis.

When adding a user, we pick reasonable defaults based on your environment and then you can modify this access.

SFTP and SCP are easy targets for brute force attacks on the internet. To protect our customers from unauthorised access, Couchdrop implements an account lockout policy by default.

After 5 incorrect attempts in 5 minutes, accounts are locked for 15 minutes.

This option can be disabled globally, but we do not recommend it.

Couchdrop allows administrators to create comprehensive password policies that enforce good password management to meet security and compliance requirements.

Global Password Policies

Under administration, Couchdrop allows admins to configure a global password policy that applies to all users. This global password policy is managed under Administration --> Security --> Password Policies

Couchdrop has three different mechanisms for alerting and notifications. Each is independant of the other and is managed slightly differently.

Global Alerting

Global alerting lives across the tenant and provides the broadest framework for providing notifications on events. You can configure global alerting to notify users when:

A key security mechanism in Couchdrop is ACLs. ACLs limit access to particular IP addresses or netwrok ranges.

There are three levels of ACL controls in Couchdrop:

• User based

• Group based

Introduction

Notifications can be set to email a specific email address when an automation either fails or succeeds.

Selecting Notifications

Notifications are set in the automation builder by clicking a plus sign and choosing Notifications.

Notifications settings

At any point of a workflow, you can choose to send a notification. Notifications can be sent on success, on failure, or when either happen by checking the appropriate boxes.

Recipient email addresses

The Recipient email address field is a text box where you can specify any email address to receive the notification. Couchdrop supports multiple email addresses separated by a comma.

Email template

Couchdrop uses pre-filled email templates for notifications. There are slight variations depending on the event, but the emails will follow a similar structure to below:

Subject: [Company name specified in Admin settings] - [Event] notification

Hi there,

Just wanted to let you know that your file [full file path] pulled by [username] has been [event] from [directory].

If you require support or assistance with this please email us on [email protected] and someone will be in contact shortly.

Thank you,

Team @ Couchdrop

Create your own secure, customer-facing file transfer portals by applying your branding to Couchdrop. Before beginning this process, we recommend you have good quality logos and your brand guide (with hex colors) available.

Configure Couchdrop Whitelabelling

1. Log in to Couchdrop as the Owner user.

2. Navigate to Administration → White labelling

3. White labelling can be configured separately for the main Couchdrop web portal and/or the Shared Link and Inbox landing pages. Check the options you wish to enable and provide a Company Name. Optionally, provide your own domain which is configured to point to Couchdrop. Use a DNS CNAME for this, eg: files.mycompany.com -> mycompany.couchdrop.io

4. Enter hex codes for your custom colors and upload your logos. You may need to manipulate the dimensions of your logo files to best suit the page layout before uploading them. Portal settings apply to the main Couchdrop login page and web portal interface. Inbox Branding applies to Shared Links and Inboxes.

5. Click Save Settings when all configuration is complete.

Introduction

Couchdrop uses a vast network of cloud computing resources to provide you with a robust and fast SFTP and file automation platform. Since we are using dynamic cloud computing, geographically located in over 15 different datacenters, we can't publish or guarantee that our IPs won't change. In fact, they do change, and very frequently.

It's a hard requirement for us

If static IPs are a hard requirement, then reach out to [email protected] and we can assign your account to a POD that is configured for them.

Introduction

Inbound webhooks in Couchdrop provide a simple and secure way to upload data directly into your storage environment over HTTPS. Instead of relying on traditional file transfer protocols or manual uploads, customers can push data to Couchdrop programmatically using standard POST requests. This makes it easy to integrate Couchdrop into existing workflows, applications, or automation pipelines without needing specialized client software.

Couchdrop’s inbound webhooks are flexible and support a wide range of payloads, including binary files, JSON documents, and raw request bodies. Whether you’re sending log files, structured data, or application-generated artifacts, Couchdrop ensures that the incoming content is captured reliably and routed to your configured storage destination. This approach enables seamless ingestion of data at scale while maintaining the simplicity and security of HTTPS-based transfer.

Requirements

To setup and use a inbound webhook for data upload you will need the following:

• Access to Couchdrop, with the appropriate user rights. Talk to your admin to get these.

• A folder or details for a cloud storage drive and rights to manage it

• Knowledge about what kind of data you are sending and any authentication requirements

Configuring an Inbound Webhook

To create the inbox, follow the steps below:

1. Login to Couchdrop and click Inbound Webhooks

2. Click Create New. If you don't see this option, talk to your administrator.

3. Provide a name for the web hook endpoint. This is simply so you can identify it.

Using an Inbound Webhook to upload data

Example 1: Upload via CURL

To upload via curl:

Example 2: Upload with Python using a stream

Example 3: Upload JSON data to a file

Introduction

Couchdrop allows for conditional filtering so that specific actions in a workflow only apply if certain conditions are met. This allows the use of one workflow for multiple scenarios and to selectively apply the workflow to specific files only.

Setting conditions

Conditions are set in the by clicking a plus sign and choosing Conditions.

Types of Filters

You can select from multiple filters when building an automation:

AND filtering

Use "Match all of these conditions (AND)" to only apply the following action when all conditions are met.

OR Filtering

Use "Match any of these conditions (OR)" to apply if a single specified condition is met.

Introduction

Couchdrop can be connected to a OneDrive folder in a few simple steps. Couchdrop works with Personal OneDrive accounts and SharePoint Sites.

Requirements

To connect a personal OneDrive folder in Couchdrop you will need:

• A licensed OneDrive Account

• A folder in OneDrive

Configuration Steps

1. Log in to Couchdrop and add a new storage connection

2. Select OneDrive from the list of available connections

3. Choose whether or not to connect as an Administrator User,

Delegating Domain-Wide Authority

Learn how to connect Google Workspace to Couchdrop with a Client ID and domain-wide delegation

Introduction

To connect a Google Workspace account to Couchdrop you need to delegate domain-wide authority so Couchdrop can access your users and migrate them automatically.

Requirements

Delegating Domain-Wide Authority requires the following:

• A Google Workspace Administrator Account to access the Admin Console

• Familiarity with the Google Admin Console

• Client ID for Google generated in Couchdrop when configuring a Google Workspace connection

Configuration Steps

1. for your Google Workspace domain.

2. Select the Security tab. If you don't see Security, select Show More from the bottom of the menu list.

3. Choose Access and data control and then API controls.

1. Click Authorize. Test that the connection in Couchdrop is successful to complete your configuration.

For more information on domain-wide delegation, see this Support article from Google:

Introduction

Couchdrop supports inbound AS2, enabling secure file exchanges with partners using the AS2 protocol to send and receive data.

Designed for EDI transfers, AS2 ensures both security and reliability. With Couchdrop, you can connect to external AS2 partners to send files outbound, or receive files as an AS2 station. This section focusses on receiving data as an AS2 station in Couchdrop from partners.

Requirements

To support receiving files via AS2 in Couchdrop - you need to create an AS2 Station to receive files from your trading partners using the AS2 protocol. Every station will have a unique URL where your partners can send you files and these files will be mapped to a folder in Couchdrop.

To set up an AS2 Station, generally, you will need the following:

• Access to Couchdrop, with the appropriate user rights. Talk to your admin to get these.

• A folder or details for a cloud storage drive and rights to manage it.

• Information from the partners you wish to receive files such as their AS2 ID and the signing certificate to validate the signature of the incoming files.

Creating an AS2 Station

To create the AS2 Station, follow the steps below:

1. Click Create New AS2 Station. If you don't see this option, talk to your administrator.

2. Provide a name for the AS2 Station. This is simply so you can identify it.

3. Provide the AS2 ID for your station. You will need to share this ID with your trading partners.

Using the AS2 Station

For the file transmission to be successful you will need to share the following information with your AS2 trading partners:

• Station AS2 ID

• Station URL

• Certificate file for signing

• Certificate file for encryption

As an option, you can use the Share Instructions action to send this information.

Introduction to Celigo with Couchdrop

Celigo is a leading iPaaS (Integration Platform as a Service) solution for enterprise users. iPaaS platforms like Celigo enable no-code integrations between internal systems - for example, connecting Salesforce with Zendesk.

Couchdrop is a Managed File Transfer (MFT) and SFTP platform designed to simplify secure B2B file transfers. It acts as a secure file transfer gateway for Celigo, allowing Celigo customers to receive files via SFTP, FTP, and other MFT protocols, and then pass them into Celigo for internal processing.

How Celigo works with Couchdrop

Celigo is configured in Couchdrop as an outbound connection. You link a Couchdrop folder to a Celigo flow via a webhook listener. Any file uploaded into that folder is securely delivered to Celigo, which then triggers the flow you have created.

Requirements

• Admin access in Couchdrop

• A Celigo flow with a Webhook listener configured

• The following details from Celigo:

Configuration Steps

Set Up the Flow in Celigo

• Create a new flow

• Add a Source and select Webhook

• Name the webhook and continue

Configure the Connection in Couchdrop

• Add a new outbound connection

• Select Celigo and provide:

  • A name for the integration

Any files uploaded into the Couchdrop folder will now be sent automatically to your Celigo flow.

Common Issues

Introduction to Google PubSub with Couchdrop

Couchdrop supports streaming data directly into Google PubSub through file actions and automations, making it effortless to bridge file-based workflows with event-driven architectures. Instead of writing custom code or maintaining integration middleware, Couchdrop can take files or payloads from virtually any source - cloud storage, SFTP/FTP, APIs, or inbound webhooks - and automatically publish them as messages to your Google PubSub.

Using Couchdrop’s automations with Google PubSub, you can transform traditional file transfers into real-time, event-driven pipelines.

How Google PubSub works with Couchdrop

Google PubSub are configured in Couchdrop as a platform integration. This type of integration does not appear directly as a as Couchdrop, rather Google PubSub is configured as a connection that you can use in a file action inside an or .

Connecting Couchdrop to a Google PubSub queue is straight-forward

Requirements

To connect to Google PubSub queue in Couchdrop you will need:

• A Google PubSub account, with a topic created that you want to upload data into

• Information about your table in PubSub topic, such as your project ID and your topic name

• Service credentials JSON file

Configuration Steps

1. Log in to Couchdrop and add a new system integration

2. Select Google PubSub from the list of available integrations

3. Provide the details above

Couchdrop can be configured for SAML authentication via the web interface.

Pre-Requisites

Users must already exist in Couchdrop for SAML login and as Couchdrop supports login via SFTP and FTP, they must have a password set as well. SAML Login is only available through the web interface.

Configuration Steps

Enable SAML SSO

Login to Couchdrop as the owner. Navigate to Administration --> SSO --> SAML SSO

You will need to provide the following details to Couchdrop so that it can connect to your identity provider.

Azure SAML Setup

Required Fields

Creating users in Couchdrop is a simple process and can be done a couple of different ways.

Creating Users Manually

To add a user to Couchdrop manually:

• Login to Couchdrop

• Navigate to Administration --> Users

• Click Create New User

From here, you will need to provide details for their account:

• Pick a username, this needs to be unique across Couchdrop

• Supply an email address. This is optional but is important if you expect the user to be used for more than just SFTP and FTP access

• Set a password.

The final step is choosing the user's root directly. Information on what is a root directory can be found .

Inviting Users to Couchdrop

Users can be invited via email to Couchdrop. When invited, users will be provided with a password and basic settings.

To invite users to Couchdrop:

• Login to Couchdrop

• Navigate to Administration --> Users

• Click the ... menu button and choose Invite User

Introduction to BigQuery with Couchdrop

Couchdrop’s native support for inserting data into BigQuery through file actions makes it incredibly simple to move data from virtually any source into your data warehouse. You can configure Couchdrop to automatically ingest files and stream their contents directly into BigQuery tables. This enables seamless integration of data coming from cloud storage, SFTP/FTP servers, APIs, or inbound webhooks - all with minimal setup.

With this capability, teams can unlock fast and reliable ingestion of structured or semi-structured data without needing to manage ETL infrastructure. Couchdrop handles the heavy lifting of getting data into BigQuery so it’s immediately available for analysis.

How BigQuery works with Couchdrop

BigQuery is configured in Couchdrop as a platform integration. This type of integration does not appear directly as a as Couchdrop needs to understand how to translate the data into rows in BigQuery. BigQuery is configured as a connection and then you can use this connection as a file action inside an or .

When you configure the file action - you provide details about the data table schema in BigQuery and how that maps to the data files being ingested by Couchdrop.

Requirements

To connect to BigQuery in Couchdrop you will need:

• A BigQuery account, with a table created that you want to upload data into

• Information about your table in BigQuery, such as your project ID, your dataset name and your table name

• Service credentials JSON file

Configuration Steps

1. Log in to Couchdrop and add a new system integration

2. Select BigQuery from the list of available integrations

3. Provide the details above

Introduction to Amazon SQS with Couchdrop

Couchdrop supports streaming data directly into Amazon SQS through file actions and automations, making it effortless to bridge file-based workflows with event-driven architectures. Instead of writing custom code or maintaining integration middleware, Couchdrop can take files or payloads from virtually any source - cloud storage, SFTP/FTP, APIs, or inbound webhooks - and automatically publish them as messages to your SQS queues.

Using Couchdrop’s automations with SQS, you can transform traditional file transfers into real-time, event-driven pipelines.

How Amazon SQS works with Couchdrop

SQS is configured in Couchdrop as a platform integration. This type of integration does not appear directly as a as Couchdrop, rather SQS is configured as a connection that you can use in a file action inside an or .

Requirements

To connect to SQS in Couchdrop you will need:

• An SQS queue already configured - take note of the queue name

• An AWS IAM Key

• An AWS IAM Secret

• The AWS region

Configuration Steps

1. Log in to Couchdrop and add a new system integration

2. Select SQS from the list of available integrations

3. Provide the details above

4. Click

Introduction to Azure Queue with Couchdrop

Couchdrop supports streaming data directly into Azure Queue through file actions and automations, making it effortless to bridge file-based workflows with event-driven architectures. Instead of writing custom code or maintaining integration middleware, Couchdrop can take files or payloads from virtually any source - cloud storage, SFTP/FTP, APIs, or inbound webhooks - and automatically publish them as messages to your Azure queues.

Using Couchdrop’s automations with Azure Queue, you can transform traditional file transfers into real-time, event-driven pipelines.

How Azure Queue works with Couchdrop

Azure Queues are configured in Couchdrop as a platform integration. This type of integration does not appear directly as a as Couchdrop, rather Azure Queue is configured as a connection that you can use in a file action inside an or .

Requirements

To connect to Azure Queue in Couchdrop you will need:

• An Azure account, with an azure queue created within a storage account - take note of the queue name, and the storage account name

• An access key for the storage account

Configuration Steps

1. Log in to Couchdrop and add a new system integration

2. Select Azure Queue from the list of available integrations

3. Provide the details above

Requirements

Required Configuration

To connect to Datadog you will need:

• Datadog Application Key

• Datadog API Key

Optional Configuration

You can configure these optional attributes

• Datadog integration name (ddsource)

• Datadog Tags (ddtags)

• Originating Hostname (hostname)

• Service Name (service)

To learn how to setup Datadog API access you can visit

Configuration Steps

1. Log in to Couchdrop and navigate to the Admin Panel - Logging

2. Select Connect/Manage on the Datadog Provider Pill

3. Select the Events to send to Datadog

Introduction to Superbase with Couchdrop

Couchdrop’s native support for inserting data into Superbase through file actions makes it incredibly simple to move data from virtually any source into your data warehouse. You can configure Couchdrop to automatically ingest files and stream their contents directly into Superbase tables. This enables seamless integration of data coming from cloud storage, SFTP/FTP servers, APIs, or inbound webhooks - all with minimal setup.

With this capability, teams can unlock fast and reliable ingestion of structured or semi-structured data without needing to manage ETL infrastructure. Couchdrop handles the heavy lifting of getting data into Superbase so it’s immediately available for analysis.

How Superbase works with Couchdrop

Superbase is configured in Couchdrop as a platform integration. This type of integration does not appear directly as a as Couchdrop needs to understand how to translate the data into rows in Superbase.

Instead; Superbase is configured as a connection and then you can use this connection as a file action inside an or .

When you configure the file action - you provide details about the data table schema in Superbase and how that maps to the data files being ingested by Couchdrop.

Requirements

To connect to Supabase in Couchdrop you will need:

• A Supabase account, with a table created that you want to upload data into

• Access credentials, such as your project ID and access key

• Your project ID is typically found in the URL in Supabase, if you navigate to your Supabase project, https://supabase.com/dashboard/project/<project-id>

Configuration Steps

1. Log in to Couchdrop and add a new system integration

2. Select Superbase from the list of available integrations

3. Provide the details above

Accessing Couchdrop via FTP and FTPs requires a user account. Inbound FTP users are independent from Administrators in Couchdrop and are designed to have limited access.

We do not recommend using your owner account as they have elevated permissions to Couchdrop and generally FTP users are shared with external systems and providers.

Creating a new User

Creating a new Inbound FTP user is done in the management dashboard from Couchdrop and is a simple two step process.

Requirements

To create a new user - you will need:

• A username and password - the username needs to be unique in Couchdrop.

• A folder location where that user will be isolated to.

• Administrator access to your Couchdrop tenant

Configuration Steps

Login to Couchdrop at -

1. From the dashboard - click "+ Create" and then choose FTP User

2. Follow the wizard to create your new user

3. Share the newly created user with your end customer

Once created - you can send connection details to the external provider or user.

You can see who has access directly in the Couchdrop SFTP section from the web app.

The root directory in Couchdrop is a key security mechanism.

When users are added, you must choose a root directory. The root directory in Couchdrop behaves a bit like the home directory in a unix environment with a couple of caveats.

• Users cannot navigate outside the root directory

• Users can only see paths relative to the root directory

• The true location of the root directory is hidden

• Users can share the same root directory

Root directories can have permissions to give added controls.

• Read only users: Can only download and view content in directory

• Write only users: Users can only upload files to the directory, they cannot view existing files or folders

Example Root Directory:

Requirements

Required Configuration

To connect to Azure Monitor you will need:

• Azure Tenant ID

• Azure Client ID

• Azure Client Secret

• Log Ingestion Endpoint

To learn how to setup Azure Monitor API access you can visit

Configuration Steps

1. Log in to Couchdrop and navigate to the Admin Panel - Logging

2. Select Connect/Manage on the Microsoft Sentinel Provider Pill

3. Select the Events to send to Azure Monitor

Requirements

Required Configuration

To connect to Splunk you will need:

• Event Collector token

• HTTP Event Collector URI

Optional Configuration

You can configure these optional attributes

• Originating Host

• Event Source Application

• Sourcetype value for the event

• Index name

To learn how to setup Splunk API access you can visit

Configuration Steps

1. Log in to Couchdrop and navigate to the Admin Panel - Logging

2. Select Connect/Manage on the Splunk Provider Pill

3. Select the Events to send to Splunk

Requirements

Required Configuration

To connect to Logstash you will need:

• Elastic Username

• Elastic Password

• Elastic Url

To learn how to setup Logstash Http input plugin you can visit

Configuration Steps

1. Log in to Couchdrop and navigate to the Admin Panel - Logging

2. Select Connect/Manage on the Elastic Provider Pill

3. Select the Events to send to Logstash

Configuring SSO with Couchdrop

Introduction

Upload Links in Couchdrop provide a simple way to request and receive files using a secure web link. They provide a brand-able, secure web portal where clients, partners, and customers can easily upload files directly to your cloud storage without needing accounts or access to your internal systems.

Connecting to Couchdrop with a SFTP client is simple. To get started, you will need:

• A username and password or

• A username and key

Introduction to Zapier with Couchdrop

Zapier is a leading iPaaS (Integration Platform as a Service) solution for consumers and small businesses. iPaaS platforms like Zapier enable no-code integrations between internal systems - for example, connecting Salesforce with Zendesk.

Couchdrop is a Managed File Transfer (MFT) and SFTP platform designed to simplify secure B2B file transfers. It acts as a secure file transfer gateway for Zapier, allowing Zapier customers to receive files via SFTP, FTP, and other MFT protocols, and then pass them into Zapier for internal processing.

The key difference between Couchdrop and other SFTP servers, is that Couchdrop works with your Cloud Storage instead of local hard disks. This means you can turn any storage platform, shared drive or server into a SFTP and MFT server in a matter of seconds.

Couchdrop is also not limited to one particular storage integration, rather you can mount hundreds of stores in Couchdrop and they appear as independent folders.

See for more info on folders in Couchdrop

Introduction

B2B Connect creates a direct pairing with an external party to allow the sending party to directly send files to the receiving party's connected directory without sharing storage account access.

Pairing configurations are handled automatically by Couchdrop. The invited party simply has to click a link in their invitation email and will be guided through setup on their own Couchdrop account.

Introduction

Connecting to SharePoint online is fast to set up and fully supported in Couchdrop. Couchdrop uses the Microsoft Graph API, which is the recommended method for connecting to SharePoint and OneDrive.

There are two different authentication methods available with SharePoint Online, Delegate Access or Application Access. The Couchdrop team recommends you use the default Delegate Access method, as it's simpler to configure.

Introduction to Boomi with Couchdrop

Boomi is a leading iPaaS (Integration Platform as a Service) solution for enterprise users. iPaaS platforms like Boomi enable no-code integrations between internal systems - for example, connecting Salesforce with Zendesk.

Couchdrop is a Managed File Transfer (MFT) and SFTP platform designed to simplify secure B2B file transfers. It acts as a secure file transfer gateway for Boomi, allowing Boomi customers to receive files via SFTP, FTP, and other MFT protocols, and then pass them into Boomi for internal processing.

Couchdrop has a very simple role structure. When thinking about users in Couchdrop, there are Internal Users and External Users.

Internal Users

Internal Users are users within your organisation. Typically, they are management users with permission to configure and manage file transfers and can create/manage External Users.

Introduction

Couchdrop supports AS2 connectors, enabling secure file exchanges with partners using the AS2 protocol. Designed for EDI transfers, AS2 ensures both security and reliability. With Couchdrop, you can connect to external AS2 partners to send files outbound, or receive files as an AS2 provider. This section focuses on configuring connections to external AS2 partners for outbound transfers.

Introduction

Couchdrop has support for scanning data prior to uploading through our integrated malware scanner. This functionality is an additional paid add-on, so reach out to if you do not have it enabled.

Malware scanning must be configured on folders to become active. This is because most customers do not want it across the board.

OpenSSH, which is a suite of secure networking utilities based on the SSH (Secure Shell) protocol, includes a command-line utility for interacting with SSH servers for file transfer purposes. This utility is simply called sftp.

How to use OpenSSH SFTP

Here's a brief overview of how to use the sftp

Overview

Couchdrop supports MFA/2FA natively through an integration with Authy (by Twilio). All users can configure 2fa for the Couchdrop Web App and when they first login to Couchdrop.

Authy supports SMS based 2FA and QR code based authenticator apps like the Microsoft Authenticator, 1password and the Google Authenticator. Setup is quick and easy and users can self manage.

Couchdrop supports multiple external logging provider like Splunk, Datadog, Azure Monitor (Sentinel), Elastic and general Webhooks to send Couchdrop events as logging data to in a json format.

Select one or multiple of the logging provider to connect to

In networks where internet access is only allowed behind a proxy server some additional manual configuration is needed.

Configuration steps

Introduction

Variables are used in Couchdrop to support custom filename and path creation in automations. Whenever setting a location or path in an automation, you can use variables to generate an appropriate path.

Available Variables

The following variables are available for automations

Introduction

Couchdrop supports several key actions when configuring and managing automations. These actions modify or move files that are being processed by Couchdrop.

Selecting Actions

Actions are set in the automation builder by clicking a plus sign and choosing Actions.

Action Nesting

Actions can be nested in Automations, which means one action depends on the success and output of the previous action. This is a unique feature of Couchdrop and allows for very complex scenarios.

If a sub-action fails, then Couchdrop will not continue to process any child actions.

For more information, see .

Available Actions

The following actions are available in Automations in Couchdrop

Introduction

Couchdrop Automated Transfers take the hassle out of moving files between systems by allowing you to schedule, trigger, and orchestrate file transfers without manual intervention. Instead of relying on scripts, cron jobs, or complex middleware, Couchdrop provides a managed way to automatically move data between your connected storage platforms, SFTP/FTP servers, or cloud environments.

With Automated Transfers, you can define rules and schedules that handle repetitive or time-sensitive workflows, such as nightly backups, hourly data syncs, or event-driven distribution of files.

Triggers

Transfer Automation have two trigger types: Manual and Scheduled. Manual triggers are only initiated by clicking the Run/Trigger Workflow button.

Scheduled triggers activate based on a configured schedule (evaluated in UTC) with the following options:

Secondary Schedules

If the Transfer Automation needs to run at multiple intervals, these can be set with Secondary Schedules.

Suppose you want to trigger the automation at noon every Friday but also on the first of the month. To do this, create one Automation for Weekly, Friday, 12:00PM, and then a Secondary schedule for Monthly 1, 12:00PM.

You can add as many Secondary Schedules as needed for a single automation.

Determining what to transfer or poll

Transfer automations require that you configure a source and choose what to transfer or poll.

Enabling Transfer Automations

To enable a Transfer Automation, click Transfer Automation Enabled in the builder or click the three dots next to the Automation name in Automations and choose Enable Schedule.

Introduction

Mailboxes in Couchdrop provide a simple way to receive files via email. When you create a mailbox - Couchdrop creates a dedicated email addresses that automatically save attachments directly to your cloud storage.

Requirements

To setup an Mailbox, generally you will need the following:

• Access to Couchdrop, with the appropriate user rights. Talk to your admin to get these.

• A folder or details for a cloud storage drive and rights to manage it

How to create the Mailbox