---
title: "Create App"
method: POST
path: "/v1/apps"
tags: ["creative-apps"]
---

# Create App

`POST /v1/apps`

## Request

- Base URL: `https://api.theagentc.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.theagentc.io/v1/apps`
- Auth: HTTP bearer

Add an app. Live apps (app_store_url) ingest store metadata/reviews;
unreleased apps create a ready draft you upload screenshots to and run the
ASC/creative pipeline against — no store lookup.

## Request body

- AppCreate: Add an app two ways: • Live: pass `app_store_url` → we ingest store metadata/reviews. • Not live yet: pass `unreleased=True` + `name` (+ optional `category`) → a draft listing you can upload screenshots to and run the ASC/creative pipeline against before it's in the store.
  - `app_store_url` string, nullable: App Store URL or bare numeric Apple app id (live apps)
  - `unreleased` boolean: App is not in the App Store yet
  - `name` string, nullable: App name (unreleased apps)
  - `category` string, nullable: Category (unreleased apps)

## Response `201`

Successful Response

- AppCreateResponse
  - `id` string, uuid, required
  - `status` string, required
  - `job_id` string, uuid, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/theagentc/apis/the-agent-c-api.md) · [All operations](https://skmtc.dev/theagentc/apis/the-agent-c-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theagentc/apis/the-agent-c-api/revisions/1c9868b44584?raw)