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

# Crear lista de datos

> Crea una lista propia del tenant con nombre, tipo, fuente y configuración opcional para usarla desde reglas y verificaciones — POST /data-lists.

## Resumen

Crea una nueva **data list** para la organización. Usá `type: "custom"` para una lista genérica que referenciarás por UUID en las reglas.

## Endpoint

```
POST https://api.gu1.ai/data-lists
```

## Autenticación

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Cuerpo de la solicitud

<ParamField body="name" type="string" required>
  Nombre visible (1–200 caracteres). Aparece en el **dashboard** (catálogo, selectores, cabeceras) para identificar la lista; **no** cambia cómo las reglas evalúan ítems.
</ParamField>

<ParamField body="type" type="string" required>
  List type enum, including `custom`, `company_blocklist`, `document_blocklist`, `keyword_list`, `ip_blocklist`, and others supported by the platform.
</ParamField>

<ParamField body="description" type="string">
  Descripción opcional (máx. 1000 caracteres). Úsala como **contexto interno** (responsable, política de actualización, caso de uso); visible donde el producto muestra el detalle de la lista. **No** la usa el motor de coincidencias.
</ParamField>

<ParamField body="source" type="string" required>
  Origin of data, e.g. `manual_entry`, `api_integration`, `custom_upload`, `internal`, etc.
</ParamField>

<ParamField body="config" type="object">
  Optional: `autoSync`, `syncFrequency`, `externalUrl`, `apiKey`, `visibleItemDataColumns`, etc.
</ParamField>

<ParamField body="fieldMappings" type="object">
  Optional string-to-string map for ingestion mappings.
</ParamField>

<ParamField body="priority" type="number" default="50">
  Priority 1–100.
</ParamField>

<ParamField body="isGlobal" type="boolean">
  Reserved for platform use; tenant clients normally omit or set `false`.
</ParamField>

## Example

```json theme={null}
{
  "name": "High-risk merchants",
  "description": "Internal blocklist for KYB rules",
  "type": "custom",
  "source": "api_integration"
}
```

## Respuesta

`201` with `success`, `data` (includes list `id`), and timing metadata on success.