> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecontra.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Create List Entry

> Add a document number, phone, email, or face hash to a list.

```bash theme={null}
curl -X POST https://identity.contra.id/v1/lists/$UUID/entries \
  -H "x-api-key: $CONTRA_KEY" -H "Content-Type: application/json" \
  -d '{
    "entry_type":   "document",
    "value":        "PASSPORT:GB:AB123456",
    "reason":       "fraud · chargeback",
    "session_id":   "sess_b3f1c2a4"
  }'
```

| Body         | Type   | Required    | Description                                                                            |
| ------------ | ------ | ----------- | -------------------------------------------------------------------------------------- |
| `entry_type` | enum   | **yes**     | `document` · `phone` · `email` · `face`.                                               |
| `value`      | string | conditional | Required for non-face entries.                                                         |
| `image`      | base64 | conditional | Required when `entry_type=face` (see [Upload Face](/api-reference/lists/upload-face)). |
| `session_id` | string | recommended | Link back to the source session for audit.                                             |
| `reason`     | string | no          | Audited.                                                                               |

## Response · 201

```json theme={null}
{
  "uuid":       "ent_a1b2…",
  "entry_type": "document",
  "list":       "lst_internal_block",
  "added_at":   1748566800
}
```