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

# Create a new KnownFaces list

`POST /api/knownfaces/lists`

## Request

- Base URL: `https://verification.trulioo.com`
- URL: `https://verification.trulioo.com/api/knownfaces/lists`
- Auth: HTTP bearer

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.dev/trulioo/apis/kyc-document-api.md) - [All operations](https://skmtc.dev/trulioo/apis/kyc-document-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trulioo/apis/kyc-document-api/revisions/53a65736c9f8?raw)