---
title: "Post new app"
method: POST
path: "/apps"
tags: ["Apps"]
---

# Post new app

`POST /apps`

Insert a new app

## Request body

- AppWrapper
  - `app` App, required
    - `name` string — Name of this app. Must be different than the image name. Can ony contain alphanumeric, -, and _.
    - `config` object — Application configuration
  - `error` ErrorBody
    - `message` string
    - `fields` string

## Response `200`

App details and stats.

- AppWrapper
  - `app` App, required
    - `name` string — Name of this app. Must be different than the image name. Can ony contain alphanumeric, -, and _.
    - `config` object — Application configuration
  - `error` ErrorBody
    - `message` string
    - `fields` string

## Other responses

- `400` — Parameters are missing or invalid.
- `409` — App already exists.
- `default` — Unexpected error

## Changes

- **2016-12-13** `156d6440b85c` — 2 info
  - added the non-success response with the status `409`
  - removed the non-success response with the status `500`
- **2016-10-14** `c0f4fbb1ba30` — 2 info
  - added the non-success response with the status `500`
  - removed the non-success response with the status `409`

[Change history](https://skmtc.dev/iron-io/apis/ironfunctions/changes/apps/post.md)

---

[API](https://skmtc.dev/iron-io/apis/ironfunctions.md) · [All operations](https://skmtc.dev/iron-io/apis/ironfunctions/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/iron-io/ironfunctions/revisions/53fd9cdd70fc/schema)