Services

Create service

Changed on Nov 3, 2026

Creates a new Render service in the specified workspace with the specified configuration.

400 with code: build_source_region_mismatch if buildSourceId names a git-backed Build Source in a different region than the service.

post/services

Request

Base URL
https://api.render.com/v1
Auth
HTTP bearer

Request body

type'static_site' | 'web_service' | 'private_service' | 'background_worker' | 'cron_job' required

namestring required

The service's name. Must be unique within the workspace.

ownerIdstring required

The ID of the workspace the service belongs to. Obtain your workspace's ID from its Settings page in the Render Dashboard.

repostring

The service's repository URL. Do not specify a branch in this string (use the branch parameter instead).

autoDeploy'yes' | 'no'

Deprecated: use autoDeployTrigger instead. You can't set both autoDeploy and autoDeployTrigger in the same request.

yes is equivalent to autoDeployTrigger: commit.
no is equivalent to autoDeployTrigger: off.

autoDeployTrigger'commit' | 'off' | 'checksPass'

Controls autodeploy behavior.

commit: Deploy each time a commit is pushed to the service's linked branch.
checksPass: Deploy each time a commit is pushed to the linked branch, but only after the commit's CI checks pass.
off: Disable autodeploys.

branchstring

The repo branch to pull, build, and deploy. If omitted, uses the repository's default branch.

rootDirstring

envVarsSchema (unresolved $ref)

secretFilesItems[] (unresolved $ref)

environmentIdstring

The ID of the environment the service belongs to, if any. Obtain an environment's ID from its Settings page in the Render Dashboard.

Response

Created

deployIdstring

Changes

Nov 3, 20266ac5d3d47362 Revision changes
- breaking
  the /////// response's property type changed from no type to string for status
- breaking
  the /////// response's property type changed from no type to string for status
- breaking
  the /////// response's property type changed from no type to string for status
- warning
  added the new 0.5c-512mb enum value to the ////// response property for the response status
- warning
  added the new 0.5c-512mb enum value to the ////// response property for the response status
- warning
  added the new 0.5c-512mb enum value to the ////// response property for the response status
- warning
  added the new 0.5c-512mb enum value to the ////// response property for the response status
- warning
  added the new 12c-24g enum value to the ////// response property for the response status
- warning
  added the new 12c-24g enum value to the ////// response property for the response status
- warning
  added the new 12c-24g enum value to the ////// response property for the response status
- warning
  added the new 12c-24g enum value to the ////// response property for the response status
- warning
  added the new 12c-48g enum value to the ////// response property for the response status
- warning
  added the new 12c-48g enum value to the ////// response property for the response status
- warning
  added the new 12c-48g enum value to the ////// response property for the response status
- warning
  added the new 12c-48g enum value to the ////// response property for the response status
- warning
  added the new 12c-96g enum value to the ////// response property for the response status
- warning
  added the new 12c-96g enum value to the ////// response property for the response status
- warning
  added the new 12c-96g enum value to the ////// response property for the response status
- warning
  added the new 12c-96g enum value to the ////// response property for the response status
- warning
  added the new 1c-2g enum value to the ////// response property for the response status
- warning
  added the new 1c-2g enum value to the ////// response property for the response status
- warning
  added the new 1c-2g enum value to the ////// response property for the response status
- warning
  added the new 1c-2g enum value to the ////// response property for the response status
- warning
  added the new 2c-16g enum value to the ////// response property for the response status
- warning
  added the new 2c-16g enum value to the ////// response property for the response status
- warning
  added the new 2c-16g enum value to the ////// response property for the response status
- warning
  added the new 2c-16g enum value to the ////// response property for the response status
- warning
  added the new 2c-4g enum value to the ////// response property for the response status
- warning
  added the new 2c-4g enum value to the ////// response property for the response status
- warning
  added the new 2c-4g enum value to the ////// response property for the response status
- warning
  added the new 2c-4g enum value to the ////// response property for the response status
- warning
  added the new 2c-8g enum value to the ////// response property for the response status
- warning
  added the new 2c-8g enum value to the ////// response property for the response status
- warning
  added the new 2c-8g enum value to the ////// response property for the response status
- warning
  added the new 2c-8g enum value to the ////// response property for the response status
- warning
  added the new 4c-16g enum value to the ////// response property for the response status
- warning
  added the new 4c-16g enum value to the ////// response property for the response status
- warning
  added the new 4c-16g enum value to the ////// response property for the response status
- warning
  added the new 4c-16g enum value to the ////// response property for the response status
- warning
  added the new 4c-32g enum value to the ////// response property for the response status
- warning
  added the new 4c-32g enum value to the ////// response property for the response status
- warning
  added the new 4c-32g enum value to the ////// response property for the response status
- warning
  added the new 4c-32g enum value to the ////// response property for the response status
- warning
  added the new 4c-8g enum value to the ////// response property for the response status
- warning
  added the new 4c-8g enum value to the ////// response property for the response status
- warning
  added the new 4c-8g enum value to the ////// response property for the response status
- warning
  added the new 4c-8g enum value to the ////// response property for the response status
- warning
  added the new 8c-16g enum value to the ////// response property for the response status
- warning
  added the new 8c-16g enum value to the ////// response property for the response status
- warning
  added the new 8c-16g enum value to the ////// response property for the response status
- warning
  added the new 8c-16g enum value to the ////// response property for the response status
- warning
  added the new 8c-32g enum value to the ////// response property for the response status
- warning
  added the new 8c-32g enum value to the ////// response property for the response status
- warning
  added the new 8c-32g enum value to the ////// response property for the response status
- warning
  added the new 8c-32g enum value to the ////// response property for the response status
- warning
  added the new 8c-64g enum value to the ////// response property for the response status
- warning
  added the new 8c-64g enum value to the ////// response property for the response status
- warning
  added the new 8c-64g enum value to the ////// response property for the response status
- warning
  added the new 8c-64g enum value to the ////// response property for the response status
- info
  added the new optional request property
- info
  added the new optional request property /////
- info
  added the new optional request property /////
- info
  added the new optional request property /////
- info
  added the new optional request property /////
- info
  the request property ///// became optional
- info
  the request property ///// became optional
- info
  the request property ///// became optional
- info
  the request property ///// became optional
- info
  the request property default value changed from starter to 0.5c-512mb
- info
  the request property default value changed from starter to 0.5c-512mb
- info
  the request property default value changed from starter to 0.5c-512mb
- info
  the request property default value changed from starter to 0.5c-512mb
- info
  request property deprecated
- info
  added the new 0.5c-512mb enum value to the request property /////
- info
  added the new 0.5c-512mb enum value to the request property /////
- info
  added the new 0.5c-512mb enum value to the request property /////
- info
  added the new 0.5c-512mb enum value to the request property /////
- info
  added the new 12c-24g enum value to the request property /////
- info
  added the new 12c-24g enum value to the request property /////
- info
  added the new 12c-24g enum value to the request property /////
- info
  added the new 12c-24g enum value to the request property /////
- info
  added the new 12c-48g enum value to the request property /////
- info
  added the new 12c-48g enum value to the request property /////
- info
  added the new 12c-48g enum value to the request property /////
- info
  added the new 12c-48g enum value to the request property /////
- info
  added the new 12c-96g enum value to the request property /////
- info
  added the new 12c-96g enum value to the request property /////
- info
  added the new 12c-96g enum value to the request property /////
- info
  added the new 12c-96g enum value to the request property /////
- info
  added the new 1c-2g enum value to the request property /////
- info
  added the new 1c-2g enum value to the request property /////
- info
  added the new 1c-2g enum value to the request property /////
- info
  added the new 1c-2g enum value to the request property /////
- info
  added the new 2c-16g enum value to the request property /////
- info
  added the new 2c-16g enum value to the request property /////
- info
  added the new 2c-16g enum value to the request property /////
- info
  added the new 2c-16g enum value to the request property /////
- info
  added the new 2c-4g enum value to the request property /////
- info
  added the new 2c-4g enum value to the request property /////
- info
  added the new 2c-4g enum value to the request property /////
- info
  added the new 2c-4g enum value to the request property /////
- info
  added the new 2c-8g enum value to the request property /////
- info
  added the new 2c-8g enum value to the request property /////
- info
  added the new 2c-8g enum value to the request property /////
- info
  added the new 2c-8g enum value to the request property /////
- info
  added the new 4c-16g enum value to the request property /////
- info
  added the new 4c-16g enum value to the request property /////
- info
  added the new 4c-16g enum value to the request property /////
- info
  added the new 4c-16g enum value to the request property /////
- info
  added the new 4c-32g enum value to the request property /////
- info
  added the new 4c-32g enum value to the request property /////
- info
  added the new 4c-32g enum value to the request property /////
- info
  added the new 4c-32g enum value to the request property /////
- info
  added the new 4c-8g enum value to the request property /////
- info
  added the new 4c-8g enum value to the request property /////
- info
  added the new 4c-8g enum value to the request property /////
- info
  added the new 4c-8g enum value to the request property /////
- info
  added the new 8c-16g enum value to the request property /////
- info
  added the new 8c-16g enum value to the request property /////
- info
  added the new 8c-16g enum value to the request property /////
- info
  added the new 8c-16g enum value to the request property /////
- info
  added the new 8c-32g enum value to the request property /////
- info
  added the new 8c-32g enum value to the request property /////
- info
  added the new 8c-32g enum value to the request property /////
- info
  added the new 8c-32g enum value to the request property /////
- info
  added the new 8c-64g enum value to the request property /////
- info
  added the new 8c-64g enum value to the request property /////
- info
  added the new 8c-64g enum value to the request property /////
- info
  added the new 8c-64g enum value to the request property /////
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  response property service/autoDeploy deprecated
- info
  the /////// response's property pattern ^dsk-[0-9a-z]{20}$ was added for the status
- info
  the /////// response's property pattern ^dsk-[0-9a-z]{20}$ was added for the status
- info
  the /////// response's property pattern ^dsk-[0-9a-z]{20}$ was added for the status

Operation history

Create service

Request

Request body

Response 201Created

Changes

Response