---
title: "Leitfaden zur Operator-API"
slug: "using-the-operator-api"
status: "update"
updated: 2026-10-22T14:33:50Z
published: 2026-10-22T14:33:50Z
canonical: "support.tulip.co/using-the-operator-api"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.tulip.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Leitfaden zur Operator-API

*Erfahren Sie, wie Sie die Operator-API einrichten*

              Advanced Content

              

This article assumes previous experience with APIs.

Das Hinzufügen von Bedienern zu Ihrer Website ist erforderlich, um die Benutzer anzulegen, die die in Tulip entwickelten Apps ausführen werden. Sie können Bediener auf zwei Arten erstellen:* Über [die Seite „Benutzer“](https://support.tulip.co/docs/adding-users-and-managing-user-roles) in **den Einstellungen*** Über ein externes System mithilfe der Tulip-API.

Die folgende Anleitung zeigt, wie Sie die Tulip-API zum Anlegen von Bedienern verwenden.

## Hinzufügen eines Operator-API-Tokens

              Feature rename

              

Prior to r383, Service Accounts were called "API Tokens".

Klicken Sie in Ihrer Tulip-Instanz auf Ihr **Profilsymbol** in der oberen rechten Ecke und wählen Sie **„Einstellungen“** aus.

![Configuring Your Tulip Account Settings_124925135](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Configuring%20Your%20Tulip%20Account%20Settings_124925135.png)

Wählen Sie **„Tulip-API“** aus und klicken Sie dann oben rechts auf die Schaltfläche **„Dienstkonto erstellen** “.

![Create%20API%20token1](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20token1.png)

Geben Sie im Menü „Erstellung“ dem API-Token einen **Namen** und wählen Sie den Geltungsbereich `„users:write` “ aus. Klicken Sie auf **„Erstellen**“.

![Create API Token](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20Token.gif)

              Note

              

Make sure to save the Service Account information for the **API Key**, **Secret**, and **Authorization Header**.

## Verwendung der Operator-API

Im Folgenden wird erläutert, wie Sie einen Operator erstellen. In diesem Beispiel wird die Erstellung mit [Postman](https://www.postman.com/) durchgeführt.

Fügen Sie zunächst Ihren API-Endpunkt zur POST-Anfrage hinzu.

              NOTE

              

If you are using a global API key, you need to specify the workspace. If your API key is workspaced scoped, it is optional.

*https://(yourinstancenamehere).tulip.co/api/v3/w/(workspace)/users*

![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222496924.png)

Wählen Sie anschließend unter „Authorization“ **die Option „Basic Auth“** aus und geben Sie den API-Schlüssel als **Benutzernamen** sowie das API-Geheimnis als **Passwort** ein.

![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497720.png)

Fügen Sie unter „Headers“ den **Auth-Header** hinzu.

![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497957.png)

Formatieren Sie die Anfrage im „Body“ so, dass sie das Objekt JSON enthält. Das allgemeine Format für diese Anfrage lautet wie folgt:

`{"role": "operator","name": "string","badge_id": "string"}`

Das sieht dann in etwa so aus:

![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222499033.png)

Klicken Sie **auf „Senden“**, um die Anfrage auszuführen. Sie erhalten eine 201-Antwort, die den Erfolg bestätigt. Zur Überprüfung können Sie Ihre Benutzerliste unter **„Einstellungen“** aufrufen und sich vergewissern, dass der Benutzer erfolgreich angelegt wurde.

![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222499593.png)

Falls die Anfrage fehlgeschlagen ist, überprüfen Sie, ob der Schlüssel und der Geheimcode korrekt sind. Weitere Informationen zu bestimmten Antwortcodes finden Sie unter [„Einführung in APIs](/r230/docs/introduction-to-apis)“.

---

Haben Sie gefunden, wonach Sie gesucht haben?

Sie können auch auf [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) vorbeischauen, um Ihre Frage zu stellen oder zu sehen, ob andere bereits ein ähnliches Problem hatten!

**JSON**

**JSON (JavaScript Object Notation)** is a light-weight, text-based data format that is used to store and transfer data.