Zum Hauptinhalt springen
POST
/
crm
/
pipelines
/
2026-03
/
{objectType}
/
{pipelineId}
/
stages
Eine Pipeline-Phase erstellen
curl --request POST \
  --url https://api.hubapi.com/crm/pipelines/2026-03/{objectType}/{pipelineId}/stages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayOrder": 123,
  "label": "<string>",
  "metadata": {},
  "stageId": "<string>"
}
'
{
  "archived": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "displayOrder": 123,
  "id": "<string>",
  "label": "<string>",
  "metadata": {},
  "updatedAt": "2023-11-07T05:31:56Z",
  "writePermissions": "CRM_PERMISSIONS_ENFORCEMENT",
  "archivedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Autorisierungen

Authorization
string
header
erforderlich

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

Pfadparameter

objectType
string
erforderlich
pipelineId
string
erforderlich

Body

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

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

writePermissions
enum<string>
erforderlich

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
archivedAt
string<date-time>

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

Last modified on May 15, 2026