---
title: "Create"
method: POST
path: "/servers"
tags: ["Servers"]
---

# Create

`POST /servers`

Create Server.

## Request body

- object
  - `name` string — The name of the server.
  - `description` string — The description of the server.
  - `ip` string — The IP of the server.
  - `port` integer — The port of the server.
  - `user` string — The user of the server.
  - `private_key_uuid` string — The UUID of the private key.
  - `server_role` 'deployment' | 'build' | 'both' — Server role.
  - `instant_validate` boolean — Instant validate.
  - `proxy_type` 'traefik' | 'caddy' | 'none' — The proxy type.

## Response `201`

Server created.

- object
  - `uuid` string — The UUID of the server.

## Other responses

- `400` — Invalid token.
- `401` — Unauthenticated.
- `404` — Resource not found.
- `422` — Validation error.

## Changes

- **2026-09-26** `f8b16020e5dd` — 1 warning, 1 info
  - removed the request property `is_build_server`
  - added the new optional request property `server_role`

[Change history](https://skmtc.dev/coollabsio/apis/coolify/changes/servers/post.md)

---

[API](https://skmtc.dev/coollabsio/apis/coolify.md) · [All operations](https://skmtc.dev/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc.dev/coollabsio/apis/coolify/revisions/5fe936a59290?raw)