---
title: "Create a new app client."
method: POST
path: "/api/apps/{app}/clients"
tags: ["Apps"]
---

# Create a new app client.

`POST /api/apps/{app}/clients`

Create a new client for the app with the specified name.
The client secret is auto generated on the server and returned. The client does not expire, the access token is valid for 30 days.

## Path parameters

- `app` string, required

## Request body

- CreateClientDto
  - `id` string, required — The ID of the client.

## Response `201`

Client created.

- ClientsDto
  - `_links` object, required — The links.
  - `items` ClientDto[], required — The clients.
    - `_links` object, required — The links.
    - `id` string, required — The client id.
    - `secret` string, required — The client secret.
    - `name` string, required — The client name.
    - `role` string, nullable — The role of the client.
    - `apiCallsLimit` integer, required — The number of allowed api calls per month for this client.
    - `apiTrafficLimit` integer, required — The number of allowed api traffic bytes per month for this client.
    - `allowAnonymous` boolean, required — True to allow anonymous access without an access token for this client.

## Other responses

- `400` — Client request not valid.
- `404` — App not found.
- `500` — Operation failed.

---

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