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

# Create SFTP credentials

`POST /headless/sftp/credentials/`

## Request body

- SftpCredentialCreate
  - `hostname` string, required
  - `port` integer, required
  - `user` string, required
  - `auth_type` 'PASSWORD' | 'KEY', required
  - `password` string — Required when auth_type is PASSWORD
  - `private_key` string — Required when auth_type is KEY (OpenSSH format)

## Response `201`

SFTP credentials created

- SftpCredential
  - `id` string, uuid
  - `hostname` string, required
  - `port` integer, required
  - `user` string, required
  - `auth_type` 'PASSWORD' | 'KEY', required
  - `key_fingerprint` string, nullable

## 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/credentials/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)