curl -X POST https://crm.vistum.com.br/api/v1/lists \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "name": "Black Friday 2026", "contactIds": ["cnt_a", "cnt_b"] }'
{ "data": { "id": "list_bf01", "name": "Black Friday 2026", "contactCount": 2, "createdAt": "2026-07-21T18:00:00.000Z" } }
Listas
Criar lista
Cria uma nova lista de contatos, opcionalmente já com contatos incluídos.
POST
/
api
/
v1
/
lists
curl -X POST https://crm.vistum.com.br/api/v1/lists \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "name": "Black Friday 2026", "contactIds": ["cnt_a", "cnt_b"] }'
{ "data": { "id": "list_bf01", "name": "Black Friday 2026", "contactCount": 2, "createdAt": "2026-07-21T18:00:00.000Z" } }
Autenticação
string
required
Bearer vg_live_<sua_chave> — API Key com escopo lists:writeBody
string
required
Nome da lista (até 120 caracteres).
string[]
IDs de contatos para já incluir (opcional, até 500). A lista pode nascer vazia.
curl -X POST https://crm.vistum.com.br/api/v1/lists \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "name": "Black Friday 2026", "contactIds": ["cnt_a", "cnt_b"] }'
{ "data": { "id": "list_bf01", "name": "Black Friday 2026", "contactCount": 2, "createdAt": "2026-07-21T18:00:00.000Z" } }
400 VALIDATION, 402 LIST_LIMIT_REACHED (cota de listas do plano atingida), 402 SUBSCRIPTION_INACTIVE.