Saltar al contenido principal
PUT
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
Reemplazar un pipeline
curl --request PUT \
  --url https://api.hubapi.com/crm/v3/pipelines/{objectType}/{pipelineId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayOrder": 123,
  "label": "<string>",
  "stages": [
    {
      "displayOrder": 1,
      "label": "Done",
      "metadata": {
        "ticketState": "CLOSED"
      }
    }
  ]
}
'
{
  "archived": false,
  "createdAt": "2019-10-30T03:30:17.883Z",
  "displayOrder": 0,
  "id": "812723471",
  "label": "My ticket pipeline",
  "stages": [
    {
      "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"
    },
    {
      "archived": false,
      "createdAt": "2019-10-30T03:30:17.883Z",
      "displayOrder": 0,
      "id": "1234914",
      "label": "Done",
      "metadata": {
        "ticketState": "CLOSED"
      },
      "updatedAt": "2019-12-07T16:50:06.678Z"
    }
  ],
  "updatedAt": "2019-12-07T16:50:06.678Z"
}

Supported products

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
pipelineId
string
requerido

Parámetros de consulta

validateDealStageUsagesBeforeDelete
boolean
predeterminado:false
validateReferencesBeforeDelete
boolean
predeterminado:false

Cuerpo

application/json
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.

stages
object[]
requerido

Las etapas asociadas con el pipeline. Pueden recuperarse y actualizarse mediante los puntos de terminación de las etapas de pipeline.

Respuesta

successful operation

A pipeline definition.

archived
boolean
requerido

Si se archiva o no el pipeline.

createdAt
string<date-time>
requerido

La fecha en que se creó el pipeline. Los pipelines predeterminados tendrán createdAt = 0.

displayOrder
integer<int32>
requerido

El orden en que se mostrará este pipeline. Si dos pipelines 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 el pipeline.

label
string
requerido

Una etiqueta única que se utiliza para organizar los pipelines en la UI de HubSpot

stages
object[]
requerido

Las etapas asociadas con el pipeline. Pueden recuperarse y actualizarse mediante los puntos de terminación de las etapas de pipeline.

updatedAt
string<date-time>
requerido

La fecha en que se actualizó por última vez el pipeline.

archivedAt
string<date-time>

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

Last modified on April 14, 2026