---
title: "Add a new Application to an Organization"
method: POST
path: "/orgs/{orgId}/apps"
tags: ["public", "Application"]
---

# Add a new Application to an Organization

`POST /orgs/{orgId}/apps`

Creates a new Application, then adds it to the specified Organization.

## Path parameters

- `orgId` string, required

## Request body

- ApplicationCreationRequest
  - `env` EnvironmentBaseRequest
    - `id` string, required — The ID the Environment is referenced as.
    - `name` string, required — The Human-friendly name for the Environment.
    - `type` string, required — The Environment Type. This is used for organizing and managing Environments.
  - `id` string, required — The ID which refers to a specific application.
  - `name` string, required — The Human-friendly name for the Application.
  - `skip_environment_creation` boolean — If true, no environment will be created with the application.

## Response `201`

The Application requested.

- ApplicationResponse — An Application is a collection of Workloads that work together. When deployed, all Workloads in an Application are deployed to the same namespace. Apps are the root of the configuration tree holding Environments, Deployments, Shared Values, and Secrets.
  - `created_at` string, required — The timestamp in UTC indicates when the Application was created.
  - `created_by` string, required — The user who created the Application.
  - `envs` EnvironmentBaseResponse[], required — The Environments associated with the Application.
    - `id` string, required — The ID the Environment is referenced as.
    - `name` string, required — The Human-friendly name for the Environment.
    - `type` string, required — The Environment Type. This is used for organizing and managing Environments.
  - `id` string, required — The ID which refers to a specific application.
  - `name` string, required — The Human-friendly name for the Application.
  - `org_id` string, required — The Organization id of this Application
  - `status` 'active' | 'deleting', required — The status of the application
  - `status_changed_at` string, date-time, required — The timestamp in UTC of when the Environment status was last changed.
  - `status_message` string — The message associated with the status of the environment

## Other responses

- `400` — The request body was unparseable.
- `401` — The Authorization header was not present or invalid.
- `409` — The supplied `id` clashes with an existing Application.

---

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