---
title: "Create SFTP connector"
method: POST
path: "/headless/sftp/connectors/"
tags: ["sftp-connectors"]
---

# Create SFTP connector

`POST /headless/sftp/connectors/`

## Request body

- SftpConnectorCreate
  - `credentials` string, uuid, required — ID of SFTP credentials to use
  - `schema` string, uuid, required — ID of import schema to use
  - `schedule` union, required
    - object
      - `type` 'every_n_minutes', required
      - `minutes` integer, required — Run every N minutes (minimum 5)
    - object
      - `type` 'daily_at_time', required
      - `time_utc` string, required — UTC time in HH:MM format (24-hour)
  - `directory` string, required — SFTP directory to monitor
  - `file_regex` string, nullable — Optional regex pattern to filter files (null accepts all files)

## Response `201`

SFTP connector created

- SftpConnector
  - `id` string, uuid
  - `credentials` string, uuid, required — ID of SFTP credentials to use
  - `schema` string, uuid, required — ID of import schema to use
  - `schedule` union, required
    - object
      - `type` 'every_n_minutes', required
      - `minutes` integer, required — Run every N minutes (minimum 5)
    - object
      - `type` 'daily_at_time', required
      - `time_utc` string, required — UTC time in HH:MM format (24-hour)
  - `directory` string, required — SFTP directory to monitor
  - `file_regex` string, nullable — Optional regex pattern to filter files (null accepts all files)

## Other responses

- `400` — Validation error

## Changes

- **2025-12-31** `6ae49a34b0e0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/dromoio/apis/dromo/changes/headless/sftp/connectors/post.md)

---

[API](https://skmtc.dev/dromoio/apis/dromo.md) · [All operations](https://skmtc.dev/dromoio/apis/dromo/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dromoio/dromo/revisions/41b60f48ecd6/schema)