---
title: "POST /apps/{appId}/backendenvironments"
method: POST
path: "/apps/{appId}/backendenvironments"
---

# POST /apps/{appId}/backendenvironments

`POST /apps/{appId}/backendenvironments`

Creates a new backend environment for an Amplify app.

## Path parameters

- `appId` string, required

## Request body

- object
  - `environmentName` string, required — The name for the backend environment.
  - `stackName` string — The AWS CloudFormation stack name of a backend environment.
  - `deploymentArtifacts` string — The name of deployment artifacts.

## Response `200`

Success

- CreateBackendEnvironmentResult — The result structure for the create backend environment request.
  - `backendEnvironment` object, required — Describes the backend environment for an Amplify app.
    - `backendEnvironmentArn` string, required — The Amazon Resource Name (ARN) for a backend environment that is part of an Amplify app.
    - `environmentName` string, required — The name for a backend environment that is part of an Amplify app.
    - `stackName` string — The AWS CloudFormation stack name of a backend environment.
    - `deploymentArtifacts` string — The name of deployment artifacts.
    - `createTime` string, date-time, required — The creation date and time for a backend environment that is part of an Amplify app.
    - `updateTime` string, date-time, required — The last updated date and time for a backend environment that is part of an Amplify app.

## Other responses

- `480` — BadRequestException
- `481` — UnauthorizedException
- `482` — NotFoundException
- `483` — InternalFailureException
- `484` — LimitExceededException

---

[API](https://skmtc.net/aws/apis/amplify.md) · [All operations](https://skmtc.net/aws/apis/amplify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/amplify/revisions/573daadbd119/schema)