---
title: "Create app"
method: POST
path: "/app"
tags: ["App (OAuth)"]
---

# Create app

`POST /app`

Create an app.

## Request body

- App — A Terminal App used for configuring an OAuth 2.0 client.
  - `id` string, required — Unique object identifier. The format and length of IDs may change over time.
  - `name` string, required — Name of the app.
  - `redirectURI` string, required — Redirect URI of the app.
  - `secret` string, required — OAuth 2.0 client secret of the app (obfuscated).

## Response `200`

OAuth 2.0 client ID and secret.

- object
  - `data` object, required
    - `id` string, required — OAuth 2.0 client ID.
    - `secret` string, required — OAuth 2.0 client secret.

## Changes

- **2025-02-25** `43a60054211e` — 1 breaking
  - added the new required request property `allOf[#/components/schemas/App]/secret`
- **2024-12-18** `416a8af6f912` — 2 info
  - api tag `App (OAuth)` added
  - api tag `Access` removed
- **2024-12-17** `967b257f759f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/terminaldotshop/apis/terminal-api/changes/app/post.md)

---

[API](https://skmtc.dev/terminaldotshop/apis/terminal-api.md) · [All operations](https://skmtc.dev/terminaldotshop/apis/terminal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminaldotshop/terminal-api/revisions/cb4577d95656/schema)