Zum Hauptinhalt springen
POST
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
/
stages
Eine Pipeline-Phase erstellen
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"
}

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 Phase, die erstellt wird (z. B. Deals oder Tickets)

pipelineId
string
erforderlich

Die eindeutige ID der Pipeline, der Phasen hinzugefügt werden.

Body

application/json

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

displayOrder
integer<int32>
erforderlich

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

label
string
erforderlich

Ein Label zum Organisieren von Pipeline-Phasen in der HubSpot-Benutzeroberfläche. Das Label jeder Pipeline-Phase muss innerhalb dieser Pipeline eindeutig sein.

metadata
object
erforderlich

Ein JSON-Objekt mit Eigenschaften, die nicht in allen Objekt-Pipelines vorhanden sind.

Bei Deal-Pipelines ist das Feld „probability“ ein Pflichtfeld ({ "probability": 0.5 }). Es zeigt die Wahrscheinlichkeit an, mit der ein Deal abgeschlossen wird. Mögliche Werte liegen zwischen 0,0 und 1,0 in Schritten von 0,1.

Bei Ticket-Pipelines ist das Feld „ticketState“ optional ({ "ticketState": "OPEN" }). Es zeigt an, ob das Ticket noch offen ist oder von einem Mitglied Ihres Support-Teams geschlossen wurde. Mögliche Werte sind OFFEN oder GESCHLOSSEN.

stageId
string

Antwort

successful operation

A pipeline stage definition.

archived
boolean
erforderlich

Ob die Pipeline archiviert ist.

createdAt
string<date-time>
erforderlich

Das Datum, an dem die Pipeline-Phase erstellt wurde. Für die Phasen von Standard-Pipelines gilt createdAt = 0.

displayOrder
integer<int32>
erforderlich

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

id
string
erforderlich

Eine von HubSpot generierte eindeutige ID, die zum Abrufen und Aktualisieren der Pipeline-Phase verwendet werden kann

label
string
erforderlich

Ein Label zum Organisieren von Pipeline-Phasen in der HubSpot-Benutzeroberfläche. Das Label jeder Pipeline-Phase muss innerhalb dieser Pipeline eindeutig sein.

metadata
object
erforderlich

Ein JSON-Objekt mit Eigenschaften, die nicht in allen Objekt-Pipelines vorhanden sind.

Bei Deal-Pipelines ist das Feld „probability“ ein Pflichtfeld ({ "probability": 0.5 }). Es zeigt die Wahrscheinlichkeit an, mit der ein Deal abgeschlossen wird. Mögliche Werte liegen zwischen 0,0 und 1,0 in Schritten von 0,1.

Bei Ticket-Pipelines ist das Feld „ticketState“ optional ({ "ticketState": "OPEN" }). Es zeigt an, ob das Ticket noch offen ist oder von einem Mitglied Ihres Support-Teams geschlossen wurde. Mögliche Werte sind OFFEN oder GESCHLOSSEN.

updatedAt
string<date-time>
erforderlich

Das Datum, an dem die Pipeline-Phase zuletzt aktualisiert wurde

archivedAt
string<date-time>

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

writePermissions
enum<string>

Definiert die Ebene des Schreibzugriffs für die Pipeline-Phase. Mögliche Werte sind „CRM_PERMISSIONS_ENFORCEMENT“, „READ_ONLY“ oder „INTERNAL_ONLY“.

Verfügbare Optionen:
CRM_PERMISSIONS_ENFORCEMENT,
INTERNAL_ONLY,
READ_ONLY
Last modified on March 24, 2026