> ## 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.

# Criar lista de dados

> Cria uma lista própria do tenant com nome, tipo, fonte e configuração opcional para uso em regras e verificações — POST /data-lists.

## Visão geral

Cria uma nova **data list** para a organização. Use `type: "custom"` para uma lista genérica referenciada por UUID nas regras.

## Endpoint

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

## Autenticação

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

## Corpo da solicitação

<ParamField body="name" type="string" required>
  Nome de exibição (1–200 caracteres). Aparece no **dashboard** (catálogo, seletores, cabeçalhos) para identificar a lista; **não** altera como as regras avaliam itens.
</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">
  Descrição opcional (máx. 1000 caracteres). Use como **contexto interno** (responsável, política de atualização, caso de uso); visível onde o produto mostra o detalhe da lista. **Não** é usada pelo motor de correspondência.
</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"
}
```

## Resposta

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