Mover de etapa · miCore

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo crm:write e a permissão Negócios (editar) do usuário responsável.
Etapa de ganho ou de perda muda a situação; etapa que pede retorno grava o próximo contato; dispara as automações da etapa. Mesma etapa: 409.
Exige Idempotency-Key: repetir a chave com o mesmo corpo devolve o resultado original, sem repetir a operação.

Referência

POST /crm/deals/{deal}/stage na Referência da API

Como fazer

cURL

curl -X POST "$MICORE_BASE_URL/crm/deals/881/stage" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "stage_id": 12,
    "contact_date": "2026-11-05",
    "contact_time": "14:30"
}'

Resposta

Resposta · 200

{
    "data": {
        "id": 1,
        "name": "string",
        "status": "aberto",
        "closed": true,
        "archived": true,
        "predicted_value": 1,
        "won_value": 1,
        "rating": 1,
        "url_origin": null,
        "client": {
            "id": 1,
            "name": "string",
            "email": null
        },
        "funnel": {
            "id": 1,
            "name": "string"
        },
        "stage": {
            "id": 1,
            "name": "string",
            "color": null,
            "is_won": true,
            "is_lost": true
        },
        "responsible": {
            "id": 1,
            "name": "string"
        },
        "origin": {
            "id": 1,
            "name": "string"
        },
        "campaign": {
            "id": 1,
            "name": "string"
        },
        "store": {
            "id": 1,
            "name": null
        },
        "tags": [
            {
                "id": 1,
                "name": "string",
                "color": null
            }
        ],
        "milestones": [
            {
                "id": 1,
                "name": "string",
                "color": null
            }
        ],
        "next_appointment_at": "2026-10-20T10:00:00-03:00",
        "won_at": "2026-10-20T10:00:00-03:00",
        "lost_at": "2026-10-20T10:00:00-03:00",
        "created_at": "2026-10-20T10:00:00-03:00",
        "updated_at": "2026-10-20T10:00:00-03:00"
    }
}

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