---
title: "Create server"
method: POST
path: "/orgs/{organization}/servers"
tags: ["Servers"]
---

# Create server

`POST /orgs/{organization}/servers`

Create a new server in the organization. Supports both standard cloud providers
and custom VPS configurations.

Processing mode: <small><code>async</code></small>

## Path parameters

- `organization` string, required

## Request body

- object
  - `name` string, required
  - `provider` string, required
  - `credential_id` integer
  - `team_id` integer, nullable
  - `type` 'app' | 'web' | 'loadbalancer' | 'database' | 'cache' | 'worker' | 'meilisearch' | 'openclaw', required
  - `ubuntu_version` '22.04' | '24.04', required
  - `php_version` 'php5' | 'php56-old' | 'php56' | 'php70' | 'php71' | 'php72' | 'php73' | 'php74' | 'php80' | 'php81' | 'php82' | 'php83' | 'php84' | 'php85'
  - `database_type` 'mysql' | 'mysql8' | 'mysql84' | 'mysql9' | 'mariadb' | 'mariadb106' | 'mariadb1011' | 'mariadb114' | 'postgres' | 'postgres13' | 'postgres14' | 'postgres15' | 'postgres16' | 'postgres17' | 'postgres18'
  - `recipe_id` integer, nullable
  - `tags` string[], nullable
  - `aws` object
    - `region_id` string
    - `size_id` string
    - `vpc_uuid` string
    - `subnet_uuid` string
    - `disk_size` integer
  - `ocean2` object
    - `region_id` string
    - `size_id` string
    - `vpc_uuid` string
    - `enable_weekly_backups` boolean
  - `hetzner` object
    - `region_id` string
    - `size_id` string
    - `network_id` integer
    - `enable_daily_backups` boolean
    - `enable_weekly_backups` boolean
  - `vultr` object
    - `region_id` string
    - `size_id` string
    - `network_id` string, uuid
  - `akamai` object
    - `region_id` string
    - `size_id` string
  - `laravel` object
    - `region_id` string
    - `size_id` string
    - `vpc_uuid` string
  - `custom` object
    - `ip_address` string
    - `private_ip_address` string, nullable
    - `ssh_port` integer
    - `behind_nat` boolean
    - `nat_ssh_port` integer, nullable
  - `add_key_to_source_control` boolean
  - `database` string

## Response `202`

`ServerResource`

## Other responses

- `403` — Authorization error
- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.net/mfullbrook/apis/forge.md) · [All operations](https://skmtc.net/mfullbrook/apis/forge/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mfullbrook/forge/revisions/24ad66d99f93/schema)