---
title: "Create a new application from an uploaded zip"
method: POST
path: "/v2/apps"
tags: ["Lifecycle", "Deployments"]
---

# Create a new application from an uploaded zip

`POST /v2/apps`

Accepts a `multipart/form-data` upload containing a single zip archive and starts the application. The response payload depends on the application language.

The caller must have at least 256 MB of available memory on their plan. Rate limited to 1 upload every 3 seconds per user.

## Response `200`

Upload accepted and the application provisioned. `description` and `subdomain` are present only when set in `squarecloud.config`; `language` is the detected runtime with version; `ram`/`cpu` are the allocated resources.

- object
  - `status` 'success', required
  - `response` object, required
    - `id` string, required — 24-char hex application identifier.
    - `name` string, required — Display name (from `DISPLAY_NAME` in `squarecloud.config`).
    - `description` string — Optional description (from `DESCRIPTION` in `squarecloud.config`). Omitted when unset.
    - `subdomain` string — Optional `<subdomain>.squareweb.app` host (from `SUBDOMAIN` in `squarecloud.config`). Omitted for non-web apps.
    - `ram` integer, required — Allocated memory in MB.
    - `cpu` number, required — Allocated CPU shares.
    - `language` object, required — Detected runtime.
      - `name` string, required — Runtime identifier. One of `javascript`, `typescript`, `python`, `java`, `elixir`, `go`, `rust`, `php`, `dotnet`, `static`.
      - `version` string, required — Detected runtime version (e.g. `22`, `3.12`).

## Other responses

- `400` — The upload was rejected by validation or storage.
- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `413` — Upload exceeded the 100 MB per-file limit.
- `415` — The request does not use `multipart/form-data`.
- `429` — The endpoint enforces its own rate limit and the caller hit the cooldown.
- `500` — An unexpected error occurred while processing the request.
- `503` — Application provisioning is temporarily unavailable due to maintenance.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)