> For the complete documentation index, see [llms.txt](https://outboundpro.gitbook.io/api-v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://outboundpro.gitbook.io/api-v1/list/criar-lista.md). # Criar lista ## Criar lista > Cria nova lista. \*\*Não é idempotente\*\* — chamadas repetidas criam listas\ > com nomes iguais (permitido). Para evitar duplicata, busque\ > \[\`list/search?nome=...\`]\(#operation/listSearch) antes.\ > \ > \### Quando usar\ > \- \*\*Sincronização inicial\*\* — ao plugar CRM externo, replica as listas\ > existentes lá pro OutboundPro.\ > \- \*\*Início de campanha\*\* — equipe planeja "Campanha Outubro 2026", cria a lista\ > via API, popula com leads via \`/lead/list\` + futuras ações de mover.\ > \- \*\*Workflow do CRM\*\* — automação no Salesforce cria lista automaticamente\ > quando uma "Wave" de novos negócios é planejada.\ > \ > \### Cuidados\ > \- \*\*Nome não é unique\*\* — duplicatas são permitidas; verifique antes se necessário.\ > \- \*\*Pública vs privada\*\* — \`publica: false\` significa só o criador vê; pra times,\ > use \`publica: true\`.\ > \ > \### Casos de uso reais\ > \- \*\*n8n/Make\*\*: gatilho "novo deal no CRM" → criar lista correspondente no\ > OutboundPro automaticamente pra rastrear prospecção daquele deal.\ > \- \*\*Cron de campanhas mensais\*\*: dia 1 de cada mês, cria lista "Sprint MM/YYYY"\ > automaticamente, equipe popula conforme o mês corre.
```json {"openapi":"3.0.3","info":{"title":"OutboundPro API","version":"2.0.0"},"tags":[{"name":"List","description":"**Listas de leads** — agrupamentos arbitrários que você cria para\norganizar prospecção (ex.: \"E-commerces SP\", \"Tecnologia ENT\", \"Black Friday 2026\").\n\nListas podem ser **públicas** (compartilhadas com todo o cliente) ou\n**privadas** (só você), ter **prevendedor** designado, cor customizada,\ne **seguidores** (usuários que recebem notificação de movimento).\n\n### Operações suportadas\n- CRUD completo (list, search, create, edit, delete).\n- Exclusão é **lógica** (soft delete; `lis_excluida = 'S'`).\n- Buscar com filtros: nome, tipo, público/privado, dono, prevendedor, período.\n"}],"servers":[{"url":"https://app.outboundpro.com.br/api","description":"Produção"}],"security":[{"TokenAuth":[]}],"components":{"securitySchemes":{"TokenAuth":{"type":"apiKey","in":"header","name":"Token","description":"Chave privada do cliente (`cli_chave_privada`). Formato UUID v4\n(36 caracteres com hífens). Aceita header em qualquer case\n(`Token`, `token`, `TOKEN`).\n"}},"schemas":{"Lista":{"type":"object","properties":{"id":{"type":"integer"},"codigo_ficticio":{"type":"integer","description":"Código curto para exibição (não use em joins; use `id`)."},"nome":{"type":"string"},"publica":{"type":"string","enum":["S","N"],"description":"S = compartilhada com todo o cliente, N = privada."},"cor_fundo":{"type":"string"},"cor_texto":{"type":"string"},"tipo":{"type":"string"},"prevendedor_id":{"type":"integer","nullable":true,"description":"Usuário responsável pela prospecção da lista."},"seguidores":{"type":"array","description":"Usuários que recebem notificação quando lead é movido na lista.","items":{"type":"object","properties":{"id":{"type":"integer"},"nome":{"type":"string"},"email":{"type":"string","format":"email"}}}},"data_cadastro":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","required":["response"],"properties":{"response":{"type":"string","enum":["error"]},"mensagem":{"type":"string","description":"Descrição do erro em pt-BR. Família Contact usa `message` (legado)."},"message":{"type":"string","description":"Equivalente inglês de `mensagem`, usado pela família Contact."}}}},"responses":{"BadRequest":{"description":"Parâmetro obrigatório ausente ou em formato inválido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Unauthorized":{"description":"Token ausente, inválido ou cliente inativo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/list/create":{"post":{"tags":["List"],"summary":"Criar lista","operationId":"listCreate","description":"Cria nova lista. **Não é idempotente** — chamadas repetidas criam listas\ncom nomes iguais (permitido). Para evitar duplicata, busque\n[`list/search?nome=...`](#operation/listSearch) antes.\n\n### Quando usar\n- **Sincronização inicial** — ao plugar CRM externo, replica as listas\n existentes lá pro OutboundPro.\n- **Início de campanha** — equipe planeja \"Campanha Outubro 2026\", cria a lista\n via API, popula com leads via `/lead/list` + futuras ações de mover.\n- **Workflow do CRM** — automação no Salesforce cria lista automaticamente\n quando uma \"Wave\" de novos negócios é planejada.\n\n### Cuidados\n- **Nome não é unique** — duplicatas são permitidas; verifique antes se necessário.\n- **Pública vs privada** — `publica: false` significa só o criador vê; pra times,\n use `publica: true`.\n\n### Casos de uso reais\n- **n8n/Make**: gatilho \"novo deal no CRM\" → criar lista correspondente no\n OutboundPro automaticamente pra rastrear prospecção daquele deal.\n- **Cron de campanhas mensais**: dia 1 de cada mês, cria lista \"Sprint MM/YYYY\"\n automaticamente, equipe popula conforme o mês corre.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["nome"],"properties":{"nome":{"type":"string"},"publica":{"type":"boolean","default":false,"description":"Se compartilha com todo o cliente."},"cor_fundo":{"type":"string","default":"#007bff"},"cor_texto":{"type":"string","default":"#ffffff"},"tipo":{"type":"string","default":"P"},"usuario_id":{"type":"integer","description":"Dono da lista. Default = usuário do token."},"prevendedor_id":{"type":"integer","description":"Responsável pela prospecção (veja [User](#tag/User))."},"exactsales_prevendedor_email":{"type":"string","format":"email"},"seguidores":{"type":"array","items":{"type":"integer"},"description":"IDs de usuários que recebem notificação."}}}}}},"responses":{"201":{"description":"Lista criada.","content":{"application/json":{"schema":{"type":"object","properties":{"response":{"type":"string","enum":["success"]},"mensagem":{"type":"string"},"lista":{"$ref":"#/components/schemas/Lista"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}} ```