---
title: "Create a new deployment."
method: POST
path: "/v3/deployments"
tags: ["Deployments"]
---

# Create a new deployment.

`POST /v3/deployments`

Required permission: `deployments_write`

## Request body

- CreateDeployment
  - `version` string, required — The version number of this deployment. The value of version can be a SemVer compliant string or any other syntax that you are using as your version numbering scheme.
  - `created` string, date-time — When was this deployment created in UTC. Defaults to current time if not specified.
  - `description` string — Optional description of this deployment. Can be markdown or clear text.
  - `userName` string — The name of the person responsible for creating this deployment. This can be the name taken from your deployment server (like Azure DevOps or Octopus).
  - `userEmail` string, email — The email of the person responsible for creating this deployment. This can be the email taken from your deployment server (like Azure DevOps or Octopus).
  - `logId` string — As default, deployments are attached all logs of the organization. If you want a deployment to attach to a single log only, set this to the ID of that log.

## Response `201`

Deployment was created.

- CreateDeploymentResult
  - `location` string, uri — The location of the created deployment.

## Other responses

- `400` — Model not valid.
- `401` — API key not valid or no access to resource.
- `402` — Tried to call the deployment API without deployment tracking enabled or trial expired.
- `404` — Specified log not found.
- `429` — A maximum of 500 requests per minute and 3600 requests per hour are permitted

---

[API](https://skmtc.net/elmah/apis/elmah-io-api.md) · [All operations](https://skmtc.net/elmah/apis/elmah-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elmah/elmah-io-api/versions/8e9c6e56e4fa/schema)