Vincular uma pessoa a uma empresa

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo clients:write e a permissão Gestão de Cadastro (editar).
Funciona pelos dois lados: na rota da pessoa, client_id é a empresa; na rota da empresa, client_id é a pessoa.
A pessoa precisa ser PF com CPF, e a empresa, PJ.
role é o papel da pessoa na empresa: partner (sócio), administrator, buyer (comprador) ou financial.
O vínculo feito pela API já nasce ativo. Se havia um pedido pendente, ele é aprovado com o papel enviado; vínculo já ativo responde 409.

Referência

POST /clients/{clientId}/company-members na Referência da API

Como fazer

Envie um POST na rota da pessoa com a empresa e o papel:

cURL

curl -X POST "$MICORE_BASE_URL/clients/42/company-members" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 812,
    "role": "buyer"
}'

Resposta

Resposta · 201

{
    "data": {
        "id": 31,
        "person": {
            "id": 42,
            "name": "Maria Oliveira",
            "cpf": "12345678909"
        },
        "company": {
            "id": 812,
            "name": "Gráfica Exemplo",
            "name_pj": "Gráfica Exemplo Ltda",
            "cnpj": "11222333000181"
        },
        "role": "buyer",
        "status": "active",
        "source": "api",
        "approved_at": "2026-11-10T09:00:00-03:00",
        "created_at": "2026-11-10T09:00:00-03:00",
        "updated_at": "2026-11-10T09:00:00-03:00"
    }
}

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