Zum Hauptinhalt springen
PUT
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
Eine Pipeline ersetzen
curl --request PUT \
  --url https://api.hubapi.com/crm/v3/pipelines/{objectType}/{pipelineId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "My replaced pipeline",
  "displayOrder": 0,
  "stages": [
    {
      "label": "In Progress",
      "displayOrder": 0,
      "metadata": {
        "ticketState": "OPEN"
      }
    },
    {
      "label": "Done",
      "displayOrder": 1,
      "metadata": {
        "ticketState": "CLOSED"
      }
    }
  ]
}
'
{
  "label": "My ticket pipeline",
  "displayOrder": 0,
  "createdAt": "2019-10-30T03:30:17.883Z",
  "updatedAt": "2019-12-07T16:50:06.678Z",
  "archived": false,
  "id": "812723471",
  "stages": [
    {
      "label": "In Progress",
      "displayOrder": 0,
      "metadata": {
        "ticketState": "OPEN"
      },
      "createdAt": "2019-10-30T03:30:17.883Z",
      "updatedAt": "2019-12-07T16:50:06.678Z",
      "archived": false,
      "id": "1234912"
    },
    {
      "label": "Done",
      "displayOrder": 0,
      "metadata": {
        "ticketState": "CLOSED"
      },
      "createdAt": "2019-10-30T03:30:17.883Z",
      "updatedAt": "2019-12-07T16:50:06.678Z",
      "archived": false,
      "id": "1234914"
    }
  ]
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

Authorization
string
header
erforderlich

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

Pfadparameter

objectType
string
erforderlich

Der Objekttyp der Pipeline, die ersetzt wird (z. B. Deals oder Tickets)

pipelineId
string
erforderlich

Die eindeutige ID für die zu ersetzende Pipeline.

Abfrageparameter

validateDealStageUsagesBeforeDelete
boolean
Standard:false

Gibt an, ob Dealphasennutzungen vor dem Löschen der Pipeline validiert werden soll.

validateReferencesBeforeDelete
boolean
Standard:false

Gibt an, ob Referenzen vor dem Löschen der Pipeline validiert werden sollen.

Body

application/json

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

displayOrder
integer<int32>
erforderlich

Die Reihenfolge, in der diese Pipeline angezeigt wird. Wenn „displayOrder“ bei zwei Pipelines übereinstimmt, werden sie alphabetisch nach Label sortiert.

label
string
erforderlich

Ein eindeutiges Label zur Organisation von Pipelines in der HubSpot-UI.

stages
object[]
erforderlich

Eingaben zur Pipeline-Phase, die zum Erstellen der neuen bzw. Ersatz-Pipeline verwendet werden

Antwort

successful operation

A pipeline definition.

archived
boolean
erforderlich

Ob die Pipeline archiviert ist.

createdAt
string<date-time>
erforderlich

The date the pipeline was created. The default pipelines will have createdAt = 0.

displayOrder
integer<int32>
erforderlich

The order for displaying this pipeline. If two pipelines have a matching displayOrder, they will be sorted alphabetically by label.

id
string
erforderlich

A unique identifier generated by HubSpot that can be used to retrieve and update the pipeline.

label
string
erforderlich

A unique label used to organize pipelines in HubSpot's UI

stages
object[]
erforderlich

Die der Pipeline zugeordneten Phasen. Diese können über die Pipeline-Phasen-Endpunkte abgerufen und aktualisiert werden.

updatedAt
string<date-time>
erforderlich

Das Datum, an dem die Pipeline zuletzt aktualisiert wurde

archivedAt
string<date-time>

Das Datum, an dem die Pipeline archiviert ist. „archivedAt“ ist nur vorhanden, wenn die Pipeline archiviert ist.

Last modified on January 26, 2026