CUBO CRM
  1. Estágio
CUBO CRM
  • Comece por aqui
  • Atividade
    • Listar todas as atividades
      GET
    • Criar nova atividade
      POST
    • Obter atividade por ID
      GET
    • Atualizar atividade
      PUT
    • Excluir atividade
      DELETE
  • Anotação
    • Criar nova anotação
      POST
    • Obter anotação por ID
      GET
    • Atualizar anotação
      PUT
    • Excluir anotação
      DELETE
  • Chave de API
    • Listar todas as chaves de API
      GET
    • Criar nova chave de API
      POST
    • Obter chave de API por ID
      GET
    • Atualizar chave de API
      PUT
    • Excluir chave de API
      DELETE
  • Categoria
    • Listar todas as categorias
      GET
    • Criar nova categoria
      POST
    • Obter categoria por ID
      GET
    • Atualizar categoria
      PUT
    • Excluir categoria
      DELETE
  • Empresa
    • Obter empresa
    • Atualizar empresa
  • Campo Personalizado
    • Listar todos os campos personalizados
    • Criar novo campo personalizado
    • Obter campo personalizado por ID
    • Atualizar campo personalizado
    • Excluir campo personalizado
  • Negociação
    • Listar todos os negócios
    • Criar novo negócio
    • Obter negócio por ID
    • Atualizar negócio
    • Excluir negócio
    • Transborda uma negociação específica
  • Dominio
    • Listar todos os domínios
    • Criar novo domínio
    • Obter domínio por ID
    • Excluir domínio
  • Motivo de Perda
    • Listar todos os motivos de perda
    • Criar motivo de perda
    • Obter motivo de perda por ID
    • Atualizar motivo de perda
    • Excluir motivo de perda
  • Organização
    • Listar todas as organizações
    • Criar nova organização
    • Obter organização por ID
    • Atualizar organização
    • Excluir organização
  • Pessoa
    • Listar todas as pessoas
    • Criar nova pessoa
    • Obter pessoa por ID
    • Atualizar pessoa
    • Excluir pessoa
  • Funil
    • Listar todos os funis
    • Criar novo funil
    • Listar funil por ID
    • Atualizar Funil
    • Excluir funil
  • Produto
    • Listar todos os produtos
    • Criar novo produto
    • Obter produto por ID
    • Atualizar produto
    • Excluir produto
  • Proposta
    • Listar todos as propostas
    • Criar proposta para negociação pelo ID
    • Obter proposta por ID
    • Atualizar proposta
  • Estágio
    • Buscar todos os estágios do funil pelo ID
      GET
    • Criar estágios
      POST
    • Obter estágios por ID
      GET
    • Atualizar estágio
      PUT
    • Excluir estágio
      DELETE
  • Modelo
    • Listar todos os modelos de mensagem
    • Criar modelo de mensagem
    • Criar modelo de mensagem para negócio pelo ID
    • Obter modelo de mensagem por ID
    • Atualizar modelo de mensagem
    • Excluir modelo de mensagem
  • Webhooks
    • Receber dados do BotConversa para criação
    • Receber dados do BotConversa para atualização
    • Receber dados do ManyChat para criação
    • Receber dados do ManyChat para atualização
  1. Estágio

Criar estágios

POST
https://api.cubosuite.com.br/stages
Descrição#
Cria uma nova etapa (stage) em um pipeline (pipe) pertencente à empresa do usuário autenticado, com controle opcional de ordem, flag de vencimento, cores de fundo e associação a campos personalizados.
Campos#
CampoTipoDescrição
namestringNome da etapa. Campo obrigatório.
descriptionstring (opcional)Descrição da etapa.
orderNrnumber (opcional)Número da ordem da etapa dentro do pipeline. Se não informado, será a próxima ordem disponível.
pipeIdnumberID do pipeline ao qual a etapa pertence. Deve existir na empresa do usuário autenticado.
rottenFlagboolean (opcional)Indicador se a etapa possui status de "vencido" (rotten).
rottenDaysnumber (opcional)Número de dias para considerar a etapa "vencida". Obrigatório se rottenFlag for true.
lightBackgroundstring (opcional)Cor de fundo clara para a etapa (ex: código hexadecimal).
darkBackgroundstring (opcional)Cor de fundo escura para a etapa (ex: código hexadecimal).
customfieldIdsarray de números (opcional)IDs de campos personalizados associados à etapa, válidos para a empresa do usuário.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.cubosuite.com.br/stages' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "Contato Inicial",
  "description": "Primeira etapa do funil de vendas",
  "pipeId": 303247,
  "orderNr": 2,
  "rottenFlag": true,
  "rottenDays": 5,
  "lightBackground": "#E0F7FA",
  "darkBackground": "#006064"
}'
Response Response Example
{
    "name": "Contato Inicial",
    "description": "Primeira etapa do funil de vendas",
    "orderNr": 2,
    "pipeId": 303247,
    "rottenFlag": true,
    "rottenDays": 5,
    "lightBackground": "#E0F7FA",
    "darkBackground": "#006064",
    "createdAt": "2025-06-23T11:53:36.108-03:00",
    "updatedAt": "2025-06-23T11:53:36.108-03:00",
    "id": 315014,
    "deals": [],
    "customfields": [],
    "pipe": {
        "id": 303247,
        "name": "Apresentação",
        "orderNr": 1,
        "companyId": 1,
        "dailyReports": null,
        "createdAt": "2025-05-23T15:55:18.000-03:00",
        "updatedAt": "2025-06-20T10:54:12.000-03:00",
        "status": "active",
        "firstRating": null,
        "seccondRating": null,
        "thirdRating": null,
        "fourthRating": null,
        "fifthRating": null,
        "showProductFormat": "setfield",
        "timeEditAnnotation": 0,
        "showCustomFieldFormat": "setfield",
        "primaryField": null,
        "meta": {
            "deleted_at": null
        }
    },
    "meta": {
        "priceDeals": null,
        "quantityDeals": 0
    }
}

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Header
Content-Type
string 
opcional
Exemplo:
application/json
Parâmetros Bodyapplication/json
name
string 
requerido
pipeId
integer 
requerido
lightText
string 
opcional
lightBackground
string 
opcional
darkText
string 
opcional
darkBackground
string 
opcional
Examples

Respostas

🟠422422
application/json
Body
name
string 
requerido
description
string 
requerido
orderNr
integer 
requerido
pipeId
integer 
requerido
rottenFlag
boolean 
requerido
rottenDays
integer 
requerido
lightBackground
string 
requerido
darkBackground
string 
requerido
createdAt
string 
requerido
updatedAt
string 
requerido
id
integer 
requerido
deals
array[string]
requerido
customfields
array[string]
requerido
pipe
object 
requerido
id
integer 
requerido
name
string 
requerido
orderNr
integer 
requerido
companyId
integer 
requerido
dailyReports
null 
requerido
createdAt
string 
requerido
updatedAt
string 
requerido
status
string 
requerido
firstRating
null 
requerido
seccondRating
null 
requerido
thirdRating
null 
requerido
fourthRating
null 
requerido
fifthRating
null 
requerido
showProductFormat
string 
requerido
timeEditAnnotation
integer 
requerido
showCustomFieldFormat
string 
requerido
primaryField
null 
requerido
meta
object 
requerido
meta
object 
requerido
priceDeals
null 
requerido
quantityDeals
integer 
requerido
errors
array [object {3}] 
requerido
rule
string 
opcional
field
string 
opcional
message
string 
opcional
Modificado em 2025-06-23 14:53:40
Página anterior
Buscar todos os estágios do funil pelo ID
Próxima página
Obter estágios por ID
Built with