post https://{subdominio}.kommo.com/api/v4/leads/pipelines//statuses
Este método permite añadir múltiples etapas. Puedes pasar descripciones de las etapas (opcional).
Limitaciones
El método está disponible solo para usuarios administradores.
Las siguientes restricciones se aplican a las descripciones de las etapas:
- Solo se pueden crear 3 descripciones de etapas para diferentes niveles de usuario.
- No puedes pasar el mismo nivel para diferentes descripciones.
- La longitud máxima de la descripción es de 1000 caracteres.
- Puedes enviar emojis en las descripciones.
- Puedes pasar los siguientes niveles en las descripciones: principiante, candidato y maestro.
Tipo de autorización
OAuth 2.0 con Token de acceso/ Token de larga duración.
Encabezado de tipo de datos cuando la solicitud es exitosa
Content-Type: application/hal+json.
Encabezado de tipo de datos en caso de un error
Content-Type: application/problem+json.
Parámetros de respuesta
El método retorna un arreglo de objetos de etapas añadidas.
| Parámetro | Tipo de dato | Descripción | |
|---|---|---|---|
| name | string | Nombre de la etapa | |
| sort | int | Número de secuencia de la etapa en el pipeline | |
| color | string | Color de la etapa | |
| request_id | string | El campo será retornado sin cambios en la respuesta y no se guardará. | |
| descriptions | array | Arreglo de descripciones de la etapa | |
| descriptions[0] | object | Objeto de descripción de la etapa | |
| descriptions[0][level] | string | Nivel de los usuarios para los cuales se crea la descripción | |
| descriptions[0][description] | string | Descripción de la etapa |