---
title: "POST /persons"
method: POST
path: "/persons"
---

# POST /persons

`POST /persons`

Creates a new person in a Person Directory. To add face to this person, please call Person Directory "Add Person Face".

## Request body

- UserDefinedFields — User defined fields for object creation.
  - `name` string, required — User defined name, maximum length is 128.
  - `userData` string — Optional user defined data. Length should not exceed 16K.

## Response `202`

A successful call returns an empty response body. The service has accepted the request and will start processing soon. The client can query the operation status and result using the URL specified in the 'Operation-Location' response header. The URL expires in 48 hours.

- CreatePersonResult — Response of create person.
  - `personId` string, uuid, required — Universally Unique Identifier

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** `44e2cf82becd` — 1 info
  - endpoint added
- **2026-07-13** `e1f63ec9983b` — 1 info
  - endpoint added
- **2026-07-13** `5375faa8d134` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/ai-face/changes/persons/post.md)

---

[API](https://skmtc.dev/azure/apis/ai-face.md) · [All operations](https://skmtc.dev/azure/apis/ai-face/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/ai-face/revisions/44e2cf82becd/schema)