Importar contatos de uma planilha

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo campaigns:write e a permissão Campanhas (editar) do usuário responsável.
nome;contato ou só contato, cabeçalho opcional, ponto e vírgula ou vírgula, até 2 MB; e-mail pela arroba e telefone com 10 dígitos ou mais; linhas inválidas são ignoradas; quantos entraram vem em meta.imported; envie multipart no campo file.
Exige Idempotency-Key: repetir a chave com o mesmo corpo devolve o resultado original, sem repetir a operação.

Referência

POST /contact-lists/{list}/contacts/import na Referência da API

Como fazer

cURL

curl -X POST "$MICORE_BASE_URL/contact-lists/7/contacts/import" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001"

Resposta

Resposta · 200

{
    "data": {
        "id": 1,
        "name": "string",
        "description": null,
        "contacts_count": 1,
        "audience": {
            "whatsapp": 1,
            "email": 1
        },
        "active": true,
        "created_at": "2026-10-20T10:00:00-03:00",
        "updated_at": "2026-10-20T10:00:00-03:00"
    },
    "meta": {
        "imported": 1
    }
}

Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.