Adicionar os contatos de clientes

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.
Cliente inativo ou sem contato ativo recusa o lote; resumo em meta (novos, reativados, já existentes).
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/clients na Referência da API

Como fazer

cURL

curl -X POST "$MICORE_BASE_URL/contact-lists/7/contacts/clients" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "client_ids": [
        42,
        57
    ]
}'

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": {
        "added": 1,
        "reactivated": 1,
        "existing": 1,
        "clients": 1
    }
}

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