Criar estágios
POST
https://api.cubosuite.com.br/stages
Descrição
Campos
| Campo | Tipo | Descrição |
|---|---|---|
| name | string | Nome da etapa. Campo obrigatório. |
| description | string (opcional) | Descrição da etapa. |
| orderNr | number (opcional) | Número da ordem da etapa dentro do pipeline. Se não informado, será a próxima ordem disponível. |
| pipeId | number | ID do pipeline ao qual a etapa pertence. Deve existir na empresa do usuário autenticado. |
| rottenFlag | boolean (opcional) | Indicador se a etapa possui status de "vencido" (rotten). |
| rottenDays | number (opcional) | Número de dias para considerar a etapa "vencida". Obrigatório se rottenFlag for true. |
| lightBackground | string (opcional) | Cor de fundo clara para a etapa (ex: código hexadecimal). |
| darkBackground | string (opcional) | Cor de fundo escura para a etapa (ex: código hexadecimal). |
| customfieldIds | array 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
Parâmetros Header
Content-Type
string
opcional
Exemplo:
application/json
Parâmetros Bodyapplication/json
Respostas
Modificado em 2025-06-23 14:53:40