---
title: "Create a new KnownFaces list"
method: POST
path: "/api/knownfaces/lists"
tags: ["KnownFaces"]
---

# Create a new KnownFaces list

`POST /api/knownfaces/lists`

Creates a new KnownFaces list

## Headers

- `Accept-Version` string, required

## Request body

- KnownFacesListCreateRequest
  - `listName` string, required — The list name (max 32 characters, alphanumeric, -, _, and space only. No duplicate entries)

## Response `201`

Created

- KnownFacesList
  - `listId` string, uuid, required — Unique list identifier.
  - `listName` string, required — The list name (max 32 characters, alphanumeric, -, _, and space only. No duplicate entries)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict
- `500` — Internal Server Error

---

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