---
title: "Create Server"
method: POST
path: "/servers"
---

# Create Server

`POST /servers`

Creates a server with the specified configuration.

## Request body

- object
  - `server` object, required — The server create options. Please see [Get Host Create Options](https://developers.bitlaunch.io/reference/view-host-create-options) for the available images, sizes, and regions for a selected host ID.
    - `name` string, required — The name of the server.
    - `hostID` integer, required — The host for the server to reside on.
    - `hostImageID` string, required — The image ID to use on the server.
    - `sizeID` string, required — The size ID of the server to be provisioned to.
    - `regionID` string, required — The region ID of the location that the server will reside at.
    - `sshKeys` string[] — An array of SSH key IDs to place on the server for authentication. Must be used if no password is designated of if the selected image does not support passwords. See [List SSH Keys](https://developers.bitlaunch.io/reference/list-ssh-keys)
    - `password` string — The root user password to set on the server. Must be used if no SSH keys designated.
    - `initscript` string — A script to run on first boot of the server. Only hosts with initscript enabled can use this feature.

## Response `200`

200

- object
  - `id` string
  - `name` string
  - `host` integer
  - `ipv4` string
  - `region` string
  - `size` string
  - `sizeDescription` string
  - `image` string
  - `imageDescription` string
  - `created` string
  - `rate` integer
  - `bandwidthUsed` integer
  - `bandwidthAllowance` integer
  - `status` string
  - `errorText` string
  - `backupsEnabled` boolean
  - `version` string
  - `abuse` boolean
  - `diskGB` integer

## Other responses

- `400` — 400
- `401` — 401

---

[API](https://skmtc.dev/bitlaunch/apis/bitlaunch-api.md) · [All operations](https://skmtc.dev/bitlaunch/apis/bitlaunch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitlaunch/bitlaunch-api/revisions/b6aec14db2d0/schema)