Skip to main content
POST
/
connections
Create connection
curl --request POST \
  --url https://api.sftpsync.io/connections \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "name": "Acme"
}'
{
  "id": "conn_123",
  "name": "Acme"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
name
string
required
​
type
enum<string>
default:SFTP

Connection kind. Defaults to SFTP. Set to EMAIL to create an email inbox connection — the email* fields then apply and SFTP fields are ignored.

Available options:
SFTP,
EMAIL
​
sftpUsername
string
​
sftpPassword
string
​
sftpPrivateKey
string
​
sftpPassphrase
string
​
useHostedSFTP
boolean
​
awsUserName
string
​
awsPublicKey
string
​
awsPassword
string
​
ipWhitelist
string[]
​
sftpServerDataId
string
​
emailAllowedSenders
string[]

EMAIL only. Allowed senders — full address (alice@acme.com) or root-domain pattern (@acme.com). Empty/omitted = accept any sender.

Maximum array length: 50
​
emailAllowedFormats
enum<string>[]

EMAIL only. Attachment accept-list. Required and non-empty for EMAIL connections.

Minimum array length: 1
Available options:
csv,
xlsx,
xls,
json,
xml,
tsv
​
emailSubjectFilter
string

EMAIL only. Case-insensitive substring required in the subject. Empty = no filter.

Maximum string length: 200
​
emailInboundAddress
string<email>

EMAIL only, create-only and immutable. Custom inbound address {workspace-slug}.{connection-slug}@in.filefeed.io. Omit to have one generated (feed-XXXX@in.filefeed.io).

Maximum string length: 320

Response

200 - application/json

Connection

An SFTP / Email / API endpoint with its credentials. Canonical name as of API version 2026-05-25 (formerly Client). Credentials (sftpPassword / sftpPrivateKey / sftpPassphrase / awsPassword) are write-only and never returned in responses.

​
id
string
required
​
name
string
required
​
type
enum<string>
required

Connection kind. Always present as of API version 2026-05-25.

Available options:
SFTP,
EMAIL
​
workspaceId
string
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
sftpUsername
string
​
useHostedSFTP
boolean
​
awsUserName
string

Server-generated slug ({name}-{workspace}). Used as clientName for outbound uploads.

​
awsPublicKey
string
​
ipWhitelist
string[]
​
sftpServerDataId
string
​
emailInbox
object

Resolved inbox config for an EMAIL connection. Returned on Connection.emailInbox, present only when type = EMAIL.