> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API para crear listas de permitidos y personalizadas > POST /v3/lists/: crea una lista de permitidos o personalizada en tu aplicación de Didit. Las listas de bloqueo se crean solas. Pago por llamada. Prompt de la API para crear una lista Copiar el prompt al portapapeles \

\`Create a new allowlist or custom list in my Didit application through the Management API.

Endpoint:
POST https://verification.didit.me/v3/lists/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs workflows: write.

Goal:
\- Create an allowlist (matching items are treated as trusted, for example to skip a duplicated-face or duplicated-IP action; it never overrides a blocklist match) or a custom list (for workflow conditions, transaction rules, or manual review).
\- System blocklists are provisioned by Didit, one per entry type. You cannot create a blocklist.

Request body (application/json):
\{
"name": "Trusted office IPs",          // required, at most 255 characters, unique among the application's lists
"description": "Office egress ranges", // optional
"list_type": "allowlist",              // required: "allowlist" or "custom"
"entry_type": "ip_address"             // required: face | document | phone | email | ip_address | device_fingerprint | wallet_address | bank_account | country | user | business | key
}

entry_type is fixed once the list exists: it decides how entry values are validated and matched.

Example call:
curl -X POST "https://verification.didit.me/v3/lists/" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Trusted office IPs", "list_type": "allowlist", "entry_type": "ip_address"}'

Example response (201):
\{
"uuid": "66666666-7777-8888-9999-000000000000",
"name": "Trusted office IPs",
"description": "",
"list_type": "allowlist",
"entry_type": "ip_address",
"is_system": false,
"entry_count": 0,
"last_entry_added_at": null,
"created_at": "2026-10-12T09:15:44.031876Z",
"updated_at": "2026-10-12T09:15:44.031876Z"
}

Persist the returned uuid: use it as list_uuid in the entry calls, and as the value of a workflow or transaction rule condition with value_type "list".

Failure modes:
\- 400: list_type is "blocklist", a required field is missing, name is longer than 255 characters, entry_type is unknown, or another list of the application already has this name ({ "name": ["A list with this name already exists for this application."] }).
\- 401: the API key has expired.
\- 403: missing x-api-key (a wrong, revoked or expired key gets 401) ({ "detail": "You do not have permission to perform this action." }), or a scoped key without workflows: write.
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects:
\- Creates a new list in the application the API key belongs to.

For the full integration shape, see /integration/integration-prompt.`

\
Pegar en Crea una lista para tu aplicación. Solo se pueden crear listas `allowlist` y `custom`: Didit aprovisiona una lista de bloqueo del sistema por cada tipo de entrada, y tú le añades entradas con [Crear entrada](https://docs.didit.me/es/management-api/lists/create-entry.md).Elige `entry_type` con cuidado: no se puede cambiar después y determina cómo se valida cada valor cuando lo añades. Consulta [Listas](https://docs.didit.me/es/management-api/lists/overview.md) para ver qué hace cada tipo de lista. ## OpenAPI ````yaml es/openapi-25.json POST /v3/lists/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificación de identidad. Autentícate con el encabezado x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/lists/: post: tags: - Lists summary: Crear una lista description: >- Crea una lista de permitidos o una lista personalizada en la aplicación a la que pertenece la clave de API. No se pueden crear listas de bloqueo: Didit aprovisiona una lista de bloqueo del sistema por cada tipo de entrada, y tú añades elementos a ella con [Crear una entrada de lista](https://docs.didit.me/es/management-api/lists/create-entry). `entry_type` no puede cambiar después de la creación y determina cómo se validan y comparan los valores de las entradas. Las entradas de una lista de permitidos marcan como de confianza los elementos coincidentes. Por ejemplo, una lista de permitidos de rostros omite la acción de rostro duplicado. Estas entradas nunca anulan una coincidencia con una lista de bloqueo. Haz referencia a cualquier lista desde una condición de regla de flujo o de transacción con `value_type: "list"`. Una clave de API con alcance limitado necesita `workflows: write`. operationId: create_list requestBody: required: true content: application/json: schema: type: object required: - name - list_type - entry_type properties: name: type: string minLength: 1 maxLength: 255 description: >- Nombre de la lista. Debe ser distinto del nombre de cualquier otra lista de la aplicación, incluidas las listas del sistema. description: type: string default: '' description: Descripción opcional en texto libre. list_type: type: string enum: - allowlist - custom description: '`allowlist` o `custom`. `blocklist` se rechaza con `400`.' entry_type: type: string enum: - face - document - phone - email - ip_address - device_fingerprint - wallet_address - bank_account - country - user - business - key description: >- Qué contiene la lista: `face`, `document` (número de documento), `phone`, `email`, `ip_address` (dirección IP o rango CIDR), `device_fingerprint`, `wallet_address`, `bank_account`, `country` (ISO 3166-1 alfa-3), `user` o `business` (tu `vendor_data`), o `key` (cualquier cadena). Determina cómo se validan y comparan los valores de las entradas. No se puede cambiar después. examples: IP allowlist: value: name: Trusted office IPs description: Office egress ranges list_type: allowlist entry_type: ip_address Custom country list: value: name: Enhanced due diligence countries list_type: custom entry_type: country responses: '201': description: La lista se creó. content: application/json: schema: $ref: '#/components/schemas/ComplianceList' examples: New allowlist: value: uuid: 22222222-3333-4444-5555-666666666666 name: Trusted office IPs description: Office egress ranges list_type: allowlist entry_type: ip_address is_system: false entry_count: 0 last_entry_added_at: null created_at: '2026-10-12T09:15:44.031876Z' updated_at: '2026-10-12T09:15:44.031876Z' '400': description: El cuerpo no es válido. content: application/json: examples: Blocklist refused: value: list_type: - >- Cannot create additional blocklist lists. System blocklists are auto-created for each application. Duplicate name: value: name: - >- A list with this name already exists for this application. Missing fields: value: name: - This field is required. list_type: - This field is required. entry_type: - This field is required. Unknown entry type: value: entry_type: - '"iban" is not a valid choice.' Name too long: value: name: - Ensure this field has no more than 255 characters. '401': description: >- La clave de API con alcance limitado ha expirado. Los demás fallos de autenticación devuelven `403`. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- Falta el encabezado `x-api-key` (una clave incorrecta, revocada o expirada recibe `401`), o una clave de API con alcance limitado no tiene `workflows: write` o se usa desde una dirección IP que no está en su lista de permitidas. content: application/json: examples: Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without workflows access: value: detail: This API key has no write access to workflows. '429': $ref: '#/components/responses/RateLimitedWrite' security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST 'https://verification.didit.me/v3/lists/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "name": "Trusted office IPs", "description": "Office egress ranges", "list_type": "allowlist", "entry_type": "ip_address" }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.lists.create( name="Trusted office IPs", description="Office egress ranges", list_type="allowlist", entry_type="ip_address", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.lists.create({ name: "Trusted office IPs", description: "Office egress ranges", list_type: "allowlist", entry_type: "ip_address", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Lists.Create(ctx, didit.ListsCreateParams{\n\tName: \"Trusted office IPs\",\n\tDescription: didit.String(\"Office egress ranges\"),\n\tListType: \"allowlist\",\n\tEntryType: \"ip_address\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import me.didit.Didit; import me.didit.types.ListsCreateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.lists().create(ListsCreateParams.builder() .name("Trusted office IPs") .description("Office egress ranges") .listType(ListsCreateParams.ListType.of("allowlist")) .entryType(ListsCreateParams.EntryType.of("ip_address")) .build()); System.out.println(result); - lang: php label: PHP source: |- lists->create([ 'name' => 'Trusted office IPs', 'description' => 'Office egress ranges', 'list_type' => 'allowlist', 'entry_type' => 'ip_address', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.lists.create( name: "Trusted office IPs", description: "Office egress ranges", list_type: "allowlist", entry_type: "ip_address" ) puts result.to_h - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Lists.CreateAsync(new ListsCreateParams { Name = "Trusted office IPs", Description = "Office egress ranges", ListType = "allowlist", EntryType = "ip_address", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: ComplianceList: type: object description: >- Una lista de bloqueo, lista de permitidos o lista personalizada de una aplicación. required: - uuid - name - description - list_type - entry_type - is_system - entry_count - last_entry_added_at - created_at - updated_at properties: uuid: type: string format: uuid description: >- Identificador de la lista. Úsalo como `list_uuid` en los endpoints de listas y de entradas, y como valor de una condición de regla de flujo o de transacción con `value_type: "list"`. name: type: string maxLength: 255 description: Nombre de la lista, único entre las listas de la aplicación. description: type: string description: Descripción en texto libre. Cadena vacía cuando no está definida. list_type: type: string enum: - blocklist - allowlist - custom description: >- `blocklist`: una coincidencia rechaza la sesión o la transacción (solo listas del sistema, una por tipo de entrada). `allowlist`: los elementos que coinciden se consideran de confianza; por ejemplo, una lista de permitidos de rostros omite la acción de rostro duplicado; nunca anula una coincidencia de una lista de bloqueo. `custom`: se usa en las condiciones de las reglas de flujos y de transacciones (`value_type: "list"`). entry_type: type: string enum: - face - document - phone - email - ip_address - device_fingerprint - wallet_address - bank_account - country - user - business - key description: >- Qué contiene la lista: `face`, `document` (número de documento), `phone`, `email`, `ip_address` (dirección IP o rango CIDR), `device_fingerprint`, `wallet_address`, `bank_account`, `country` (ISO 3166-1 alfa-3), `user` o `business` (tu `vendor_data`), o `key` (cualquier cadena). Determina cómo se validan y comparan los valores de las entradas. is_system: type: boolean description: >- `true` para las listas que crea Didit: una lista de bloqueo por tipo de entrada (`face`, `document`, `phone`, `email`, `ip_address`, `device_fingerprint`, `wallet_address`, `bank_account`, `user`, `business`), la lista personalizada **High Risk Countries** y las listas de permitidos del sistema. Las listas del sistema no se pueden renombrar, editar ni eliminar; puedes añadir y eliminar sus entradas. entry_count: type: integer minimum: 0 description: Número de entradas que hay actualmente en la lista. last_entry_added_at: type: string format: date-time nullable: true description: >- Fecha y hora en que se añadió la entrada vigente más reciente. `null` si la lista está vacía. created_at: type: string format: date-time description: Fecha y hora en que se creó la lista. updated_at: type: string format: date-time description: Fecha y hora de la última actualización de la lista. responses: RateLimitedWrite: description: >- Se superó el límite de escritura compartido de 300 solicitudes por minuto por clave de API. Respeta `Retry-After` antes de reintentar. content: application/json: schema: type: object required: - detail properties: detail: type: string example: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.