[Skip to content](https://coolify.io/docs/api-reference/api/operations/create-service#VPContent)

Return to top

Create service[​](https://coolify.io/docs/api-reference/api/operations/create-service#create-service)

======================================================================================================

POST

/services

Create a one-click / custom service

Authorizations[​](https://coolify.io/docs/api-reference/api/operations/create-service#authorizations)

------------------------------------------------------------------------------------------------------

bearerAuth

Go to `Keys & Tokens` / `API tokens` and create a new token. Use the token as the bearer token.

Type

HTTP (bearer)

Request Body[​](https://coolify.io/docs/api-reference/api/operations/create-service#request-body)

--------------------------------------------------------------------------------------------------

application/json

SchemaJSON

JSON

{

"type": "string",

"name": "string",

"description": "string",

"project\_uuid": "string",

"environment\_name": "string",

"environment\_uuid": "string",

"server\_uuid": "string",

"destination\_uuid": "string",

"instant\_deploy": false,

"docker\_compose\_raw": "string",

"urls": \[\
\
{\
\
"name": "string",\
\
"url": "string"\
\
}\
\
\],

"force\_domain\_override": false,

"is\_container\_label\_escape\_enabled": true

}

Responses[​](https://coolify.io/docs/api-reference/api/operations/create-service#responses)

--------------------------------------------------------------------------------------------

201400401409422

Service created successfully.

Content-Type

application/json

SchemaJSON

JSON

{

"uuid": "string",

"domains": \[\
\
"string"\
\
\]

}

POST

/services

Playground[​](https://coolify.io/docs/api-reference/api/operations/create-service#playground)

----------------------------------------------------------------------------------------------

Authorization

bearerAuth

Body

Try it out

Samples[​](https://coolify.io/docs/api-reference/api/operations/create-service#samples)

----------------------------------------------------------------------------------------

Powered by [VitePress OpenAPI](https://github.com/enzonotario/vitepress-openapi)