Skip to main content

​
Endpoint

POST /v1/deals/:id/move
Escopo necessário: write:deals

​
Corpo da requisição

CampoTipoObrigatórioDescrição
stage_idstringSimID da etapa de destino (dentro do funil de venda)
pipeline_idstringNãoID do pipeline de destino (se diferente do atual)

​
Obtendo IDs de etapas

Use GET /v1/pipelines/:id para ver as etapas e seus IDs.

​
Exemplo de requisição

curl -X POST https://api.socialsell.ai/v1/deals/664c1d2e3f4a5b6789012347/move \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"stage_id": "664e3f4a5b6c7d8901234567"}'

​
Exemplo de resposta

{
  "data": {
    "id": "664c1d2e3f4a5b6789012347",
    "title": "Proposta Enterprise ACME",
    "stage": { "name": "Negociação" },
    "updated_at": "2026-06-10T16:00:00.000Z"
  }
}
A movimentação dispara o evento deal.stage.changed em webhooks configurados.

​
Erros

CódigoStatusDescrição
MISSING_STAGE_ID400Campo stage_id ausente
NOT_FOUND404Negócio não encontrado
PIPELINE_NOT_FOUND404Funil de venda não encontrado
STAGE_NOT_FOUND404Etapa não encontrada no funil de venda