---
title: "Creating a new App User"
method: POST
path: "/v1/projects/{projectId}/app-users"
tags: ["App Users"]
---

# Creating a new App User

`POST /v1/projects/{projectId}/app-users`

The only information required to create a new `App User` is its `displayName` (this is called "Nickname" in the administrative panel).

When an App User is created, they are assigned no rights. They will be able to authenticate and list forms on a mobile client, but the form list will be empty, as the list only includes Forms that the App User has read access to. Once an App User is created, you'll likely wish to use the [Form Assignments resource](/central-api-form-management/#form-assignments) to actually assign the `app-user` role to them for the Forms you wish.

## Path parameters

- `projectId` number, required

## Response `200`

OK

- object
  - `createdAt` string, required — ISO date format
  - `displayName` string, required — All `Actor`s, regardless of type, have a display name
  - `id` number, required
  - `type` 'user' | 'field_key' | 'public_link' | 'singleUse', required — the Type of this Actor; typically this will be `user`.
  - `updatedAt` string — ISO date format
  - `deletedAt` string — ISO date format
  - `token` string — If present, this is the Token that can be used to authenticate a request as this `App User`. If not present, this `App User`'s access has been revoked.
  - `projectId` number, required — The ID of the `Project` that this `App User` is bound to.

## Other responses

- `400` — Bad Request
- `403` — Forbidden

## Changes

- **2025-03-13** `e8c2858fd4eb` — 1 warning, 2 info
  - removed the request property `properties`
  - api operation id `createAppUser` removed and replaced with `Creating a new App User`
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/projects/:projectId/app-users/post.md)

---

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