Saltar al contenido principal
POST
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
/
stages
Crear una etapa de pipeline
curl --request POST \
  --url https://api.hubapi.com/crm/v3/pipelines/{objectType}/{pipelineId}/stages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayOrder": 1,
  "label": "Done",
  "metadata": {
    "ticketState": "CLOSED"
  }
}
'
{
  "archived": false,
  "createdAt": "2019-10-30T03:30:17.883Z",
  "displayOrder": 0,
  "id": "1234912",
  "label": "In Progress",
  "metadata": {
    "ticketState": "OPEN"
  },
  "updatedAt": "2019-12-07T16:50:06.678Z"
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

​
Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Parámetros de ruta

​
objectType
string
requerido

El tipo de objeto de la etapa que se está creando (por ejemplo, negocios o tickets)

​
pipelineId
string
requerido

El identificador único del pipeline al que se agregará la etapa.

Cuerpo

application/json

An input used to create or replace a pipeline stage's definition.

​
displayOrder
integer<int32>
requerido

El orden en que se mostrará esta etapa de pipeline. Si dos etapas de pipeline tienen un "displayOrder" coincidente, se ordenarán alfabéticamente por etiqueta.

​
label
string
requerido

Una etiqueta que se utiliza para organizar las etapas de pipeline en la UI de HubSpot. Cada etiqueta de etapa de pipeline debe ser única dentro de ese pipeline.

​
metadata
object
requerido

Un objeto JSON que contiene propiedades que no están presentes en todos los pipelines de objetos.

Para los pipelines de "negocios", el campo "probabilidad" es obligatorio ("{ "probability": 0.5 }"), y representa la probabilidad de que un negocio se cierre. Los valores posibles están entre 0.0 y 1.0 en incrementos de 0.1.

Para los pipelines de "tickets", el campo "ticketState" es opcional ("{ "ticketState": "OPEN" }"), y representa si el ticket permanece abierto o si ha sido cerrado por un miembro de tu equipo de Asistencia técnica. Los valores posibles son "ABIERTO" o "CERRADO".

​
stageId
string

Respuesta

successful operation

A pipeline stage definition.

​
archived
boolean
requerido

Si se archiva o no el pipeline.

​
createdAt
string<date-time>
requerido

La fecha en que se creó la etapa de pipeline. Las etapas de los pipelines predeterminados tendrán createdAt = 0.

​
displayOrder
integer<int32>
requerido

El orden en que se mostrará esta etapa de pipeline. Si dos etapas de pipeline tienen un "displayOrder" coincidente, se ordenarán alfabéticamente según la etiqueta.

​
id
string
requerido

Un identificador único generado por HubSpot que se puede utilizar para recuperar y actualizar la etapa de pipeline.

​
label
string
requerido

Una etiqueta que se utiliza para organizar las etapas de pipeline en la UI de HubSpot. Cada etiqueta de etapa de pipeline debe ser única dentro de ese pipeline.

​
metadata
object
requerido

Un objeto JSON que contiene propiedades que no están presentes en todos los pipelines de objetos.

Para los pipelines de "negocios", el campo "probabilidad" es obligatorio ("{ "probability": 0.5 }"), y representa la probabilidad de que un negocio se cierre. Los valores posibles están entre 0.0 y 1.0 en incrementos de 0.1.

Para los pipelines de "tickets", el campo "ticketState" es opcional ("{ "ticketState": "OPEN" }"), y representa si el ticket permanece abierto o si ha sido cerrado por un miembro de tu equipo de Asistencia técnica. Los valores posibles son "ABIERTO" o "CERRADO".

​
updatedAt
string<date-time>
requerido

La fecha en que se actualizó por última vez la etapa de pipeline.

​
archivedAt
string<date-time>

La fecha en que se archivó el pipeline. "archivedAt" solo estará presente si se archiva el pipeline.

​
writePermissions
enum<string>

Define el nivel de acceso de escritura para la etapa del pipeline, y los valores posibles son CRM_PERMISSIONS_ENFORCEMENT, READ_ONLY o INTERNAL_ONLY.

Opciones disponibles:
CRM_PERMISSIONS_ENFORCEMENT,
INTERNAL_ONLY,
READ_ONLY
Last modified on March 30, 2026