---
title: "Create"
method: POST
path: "/applications/{application_id}/deployments.json"
tags: ["Applications"]
---

# Create

`POST /applications/{application_id}/deployments.json`

## Request

- Base URL: `https://api.newrelic.com/v2`
- URL: `https://api.newrelic.com/v2/applications/{application_id}/deployments.json`
- Auth: API key in header `Api-Key`
- TypeScript: <https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2/docs/applications/:application_id/deployments.json/post.ts> (a function with typed inputs; its response is checked against the schema)

This API endpoint creates a deployment record for a given application. Deployment records are created with the following attributes:

Required:  
  - Application ID  
  - Revision, such as a git SHA  

Optional:  
  - Changelog  
  - Description  
  - User posting the deployment  

Note that the time of your deployment will be recorded as the current time in UTC.

## Path parameters

- `application_id` integer, required

## Request body

- Deployment
  - `deployment` DeploymentBody
    - `changelog` string
    - `description` string
    - `revision` string
    - `user` string

## Response `200`

No response was specified

- DeploymentResponse
  - `deployment` DeploymentResponseType
    - `changelog` string
    - `description` string
    - `id` integer
    - `links` DeploymentLinksResponse
      - `application` integer
    - `revision` string
    - `timestamp` string, date-time
    - `user` string

---

[API](https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2.md) - [All operations](https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2/revisions/cf1843ad0a45?raw)