---
title: "Create service"
method: POST
path: "/services"
tags: ["Services"]
---

# Create service

`POST /services`

Create a one-click / custom service

## Request body

- object
  - `type` string — The one-click service type (e.g. "actualbudget", "calibre-web", "gitea-with-mysql" ...)
  - `name` string — Name of the service.
  - `description` string, nullable — Description of the service.
  - `project_uuid` string, required — Project UUID.
  - `environment_name` string, required — Environment name. You need to provide at least one of environment_name or environment_uuid.
  - `environment_uuid` string, required — Environment UUID. You need to provide at least one of environment_name or environment_uuid.
  - `server_uuid` string, required — Server UUID.
  - `destination_uuid` string — Destination UUID. Required if server has multiple destinations.
  - `instant_deploy` boolean — Start the service immediately after creation.
  - `docker_compose_raw` string — The base64 encoded Docker Compose content.
  - `urls` object[] — Array of URLs to be applied to containers of a service.
    - `name` string — The service name as defined in docker-compose.
    - `url` string — Comma-separated list of URLs (e.g. "https://app.coolify.io,https://app2.coolify.io").
  - `force_domain_override` boolean — Force domain override even if conflicts are detected.
  - `is_container_label_escape_enabled` boolean — Escape special characters in labels. By default, $ (and other chars) is escaped. If you want to use env variables inside the labels, turn this off.
  - `tags` string[] — Tags to assign to the service.

## Response `201`

Service created successfully.

- object
  - `uuid` string — Service UUID.
  - `domains` string[] — Service domains.

## Other responses

- `400` — Invalid token.
- `401` — Unauthenticated.
- `409` — Domain conflicts detected.
- `422` — Validation error.

---

[API](https://skmtc.net/coollabsio/apis/coolify.md) · [All operations](https://skmtc.net/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coollabsio/coolify/revisions/08be5dc8e729/schema)