Zendesk API: Die vollständige Anleitung für Entwickler im Jahr 2026

Wenn Sie jemals die Ticketerstellung automatisieren, Daten für benutzerdefinierte Berichte abrufen oder Zendesk in Ihre anderen Tools integrieren wollten, ist die Zendesk API das, was dies ermöglicht. Sie ist die Brücke zwischen Zendesk und dem Rest Ihres Tech-Stacks.

Aber wo fangen Sie an? Die Dokumentation ist umfassend, was großartig ist, sobald Sie wissen, wonach Sie suchen. Nicht so toll, wenn Sie auf einen leeren Terminal starren und sich fragen, welchen Endpunkt Sie zuerst aufrufen sollen.

Dieser Leitfaden behandelt, was die Zendesk API tatsächlich ist, wie man sich authentifiziert, die wichtigsten Endpunkte, die Sie am häufigsten verwenden werden, und einige praktische Beispiele, um Ihnen den Einstieg zu erleichtern.

Was ist die Zendesk API?

Stellen Sie sich eine API wie einen Kellner in einem Restaurant vor. Sie sitzen am Tisch (Ihre Anwendung) und bestellen ein Gericht (Daten anfordern oder eine Aktion). Der Kellner bringt diese Bestellung in die Küche (die Server von Zendesk) und bringt Ihr Essen zurück (die Antwort). Die API ist der Bote, der den Austausch ermöglicht.

Die Zendesk API ist eine REST-API, die JSON für den gesamten Datenaustausch verwendet. Sie folgt den Standard-REST-Konventionen: Sie verwenden HTTP-Methoden wie GET, um Daten abzurufen, POST, um zu erstellen, PUT, um zu aktualisieren, und DELETE, um zu entfernen. Die API bietet Ihnen programmatischen Zugriff auf Tickets, Benutzer, Organisationen, Help Center-Inhalte und mehr.

Warum die API anstelle der Weboberfläche verwenden? Einige Szenarien fallen mir ein:

• Massenoperationen: Erstellen Sie 100 Tickets auf einmal, anstatt sich einzeln durch die Benutzeroberfläche zu klicken
• Datenexport: Ziehen Sie Ticketdaten in Ihre eigenen Berichtstools oder Ihr Data Warehouse
• Integrationen: Verbinden Sie Zendesk mit Ihrem CRM, internen Tools oder benutzerdefinierten Anwendungen
• Automatisierung: Lösen Sie Aktionen in Zendesk basierend auf Ereignissen in anderen Systemen aus

Für Teams, die Automatisierung ohne Programmieren wünschen, gibt es Alternativen. Wir haben eesel AI entwickelt, um als KI-Teamkollege innerhalb von Zendesk zu arbeiten und Tickets autonom zu bearbeiten, ohne API-Integrationsarbeit. Aber wenn Sie benutzerdefinierte Funktionen benötigen, ist die API der richtige Weg.

Erste Schritte mit der Zendesk API-Authentifizierung

Bevor Sie API-Aufrufe tätigen können, müssen Sie sich authentifizieren. Zendesk bietet zwei Hauptmethoden an: API-Token und OAuth.

API-Token-Authentifizierung

API-Token sind der schnellste Weg, um loszulegen. Es handelt sich um automatisch generierte Passwörter, die Sie in Ihrem Zendesk Admin Center unter Apps und Integrationen > APIs > Zendesk API erstellen.

Folgendes müssen Sie wissen:

• Sie können bis zu 256 aktive Token pro Konto haben
• Token fungieren als Passwörter und können jeden Benutzer imitieren, einschließlich Administratoren
• Verwenden Sie das Format {email_address}/token:{api_token} für die Authentifizierung

Eine Curl-Anfrage mit einem API-Token sieht wie folgt aus:

curl https://your-subdomain.zendesk.com/api/v2/tickets.json \
  -u jdoe@example.com/token:6wiIBWbGkBMo1mRDMuVwkw1EPsNkeUj95PIz2akv

Quelle: Zendesk Sicherheit und Authentifizierung

OAuth-Zugriffstoken

OAuth ist die bessere Wahl, wenn Sie eine App für mehrere Zendesk-Kunden erstellen oder clientseitige API-Anfragen von einem Browser aus stellen müssen. OAuth-Token sind auf eine einzelne Zendesk-Instanz beschränkt und verwenden das Bearer-Token-Format:

Authorization: Bearer gErypPlm4dOVgGRvA1ZzMH5MQ3nLo8bo

Wenn Sie eine App an mehrere Kunden verteilen, müssen Sie globale OAuth-Token verwenden. Reguläre API-Token funktionieren nicht, da Zendesk Kunden untersagt, ihre Anmeldeinformationen an Dritte weiterzugeben.

Ratenbegrenzung

Alle API-Anfragen unterliegen Ratenbegrenzungen (Rate Limiting). Wenn Sie Ihr Limit überschreiten, erhalten Sie eine 429 Too Many Requests-Antwort mit einem Retry-After-Header, der Ihnen mitteilt, wie lange Sie warten müssen.

Antwort-Header enthalten Ihren aktuellen Ratenbegrenzungsstatus:

X-Rate-Limit: 700
X-Rate-Limit-Remaining: 699

Quelle: Zendesk Ratenbegrenzungen

Wichtige Zendesk API-Endpunkte und ihre Funktionen

Die Zendesk API ist um Ressourcen herum organisiert: Tickets, Benutzer, Organisationen usw. Hier sind die Endpunkte, die Sie am häufigsten verwenden werden.

Tickets API

Die Tickets API ist der Ort, an dem Sie die meiste Zeit verbringen werden. Sie verwaltet die Kernfunktionen des Supports.

Wichtige Endpunkte:

• GET /api/v2/tickets.json - Tickets auflisten (paginiert, 100 pro Seite)
• POST /api/v2/tickets.json - Ein neues Ticket erstellen
• GET /api/v2/tickets/{id}.json - Ein bestimmtes Ticket abrufen
• PUT /api/v2/tickets/{id}.json - Ein Ticket aktualisieren
• DELETE /api/v2/tickets/{id}.json - Ein Ticket löschen

Mit Massenoperationen können Sie mit bis zu 100 Tickets gleichzeitig arbeiten. Dies ist nützlich für Massenaktualisierungen oder Importe. Die API unterstützt auch Idempotenzschlüssel für die Ticketerstellung, wodurch doppelte Tickets verhindert werden, wenn Sie eine fehlgeschlagene Anfrage wiederholen müssen.

Quelle: Zendesk Ticketing API

Benutzer- und Organisations-API

Die Verwaltung Ihrer Kundendaten erfolgt über die Benutzer- und Organisations-APIs.

Wichtige Endpunkte:

• GET /api/v2/users.json - Alle Benutzer auflisten
• POST /api/v2/users.json - Einen Benutzer erstellen
• GET /api/v2/organizations.json - Organisationen auflisten
• POST /api/v2/organizations.json - Eine Organisation erstellen

Mit der API können Sie bis zu 100 Organisationen in einer einzigen Anfrage erstellen. Vergleichen Sie das mit der Benutzeroberfläche, wo Sie jeweils nur eine erstellen können. Wenn Sie von einem anderen System migrieren, spart Ihnen die API Stunden.

Such-API

Die Such-API ist eines der leistungsstärksten Tools in der Zendesk API. Sie kann Tickets, Benutzer, Organisationen und Gruppen mithilfe derselben Abfragesyntax wie die Zendesk-Weboberfläche finden.

Der Endpunkt ist einfach:

GET /api/v2/search?query={query}

Aber die Abfragesyntax ist der Ort, an dem die Leistung liegt. Sie können suchen nach:

• Ticketstatus: type:ticket status:open
• Tags: tags:escalation_one,escalation_two
• Datumsbereiche: created>2024-01-01
• Benutzerdefinierte Felder: custom_field_123:priority

Ein wichtiger Vorteil gegenüber der Benutzeroberfläche: Die Such-API enthält archivierte Tickets. Zendesk-Ansichten filtern archivierte Tickets nach 120 Tagen heraus, aber die API-Suche findet alles.

Die Such-API hat eine eigene Ratenbegrenzung von 2.500 Anfragen pro Minute und gibt bis zu 1.000 Ergebnisse pro Abfrage zurück. Verwenden Sie für größere Datensätze den Endpunkt Export Search Results mit cursorbasierter Paginierung.

Quelle: Zendesk Search API

Help Center API

Wenn Sie Zendesk Guide für Ihre Wissensdatenbank verwenden, können Sie mit der Help Center API Artikel, Kategorien und Community-Beiträge programmgesteuert verwalten. Sie können Inhalte erstellen, Übersetzungen verwalten (40+ Sprachen werden in höheren Plänen unterstützt) und Artikelberechtigungen steuern.

Praktische Zendesk API-Beispiele

Sehen wir uns einige reale Beispiele an, die Sie für Ihre eigenen Anwendungsfälle anpassen können.

Erstellen eines Tickets mit curl

Hier ist ein vollständiges Beispiel für das Erstellen eines Tickets:

curl https://your-subdomain.zendesk.com/api/v2/tickets.json \
  -d '{"ticket": {"subject": "Drucker offline", "comment": { "body": "Mein Drucker ist offline. Neustarten hilft nicht." }}}' \
  -H "Content-Type: application/json" \
  -v -u jdoe@example.com/token:YOUR_API_TOKEN -X POST

Aufschlüsselung:

• Das Flag -d sendet die JSON-Nutzlast mit dem Betreff und Kommentar des Tickets
• Content-Type: application/json teilt Zendesk mit, dass Sie JSON senden
• -u stellt Ihre Anmeldeinformationen bereit
• -X POST gibt an, dass dies ein Erstellungsvorgang ist

Eine erfolgreiche Antwort gibt einen 201 Created-Status mit dem vollständigen Ticketobjekt zurück, einschließlich der zugewiesenen ID.

Suchen von Tickets nach Tag

Angenommen, Sie müssen alle Tickets finden, die sowohl mit escalation_one als auch mit escalation_two für einen vierteljährlichen Bericht gekennzeichnet sind. Die UI-Ansichten zeigen keine archivierten Tickets an, daher verwenden Sie die API:

curl "https://your-subdomain.zendesk.com/api/v2/search.json" \
  -G --data-urlencode "query=tags:escalation_one,escalation_two" \
  -v -u jdoe@example.com/token:YOUR_API_TOKEN

Das Flag -G weist curl an, die Daten als URL-Parameter anzuhängen, und --data-urlencode verarbeitet die URL-Codierung automatisch. Diese Abfrage gibt alle Tickets mit beiden Tags zurück, einschließlich archivierter.

Massenaktualisierung von Benutzerdatensätzen

Wenn Sie mehrere Benutzer gleichzeitig aktualisieren müssen, verwenden Sie den Massenaktualisierungs-Endpunkt:

curl https://your-subdomain.zendesk.com/api/v2/users/update_many.json \
  -d '{"users": [{"id": 123, "tags": ["vip"]}, {"id": 456, "tags": ["vip"]}]}' \
  -H "Content-Type: application/json" \
  -v -u jdoe@example.com/token:YOUR_API_TOKEN -X PUT

Dies aktualisiert beide Benutzer in einer einzigen Anfrage. Denken Sie an die Grenzen: Sie können bis zu 100 Benutzer gleichzeitig aktualisieren, und es gibt eine Ratenbegrenzung von 5 Anfragen pro Minute und Benutzer.

Zendesk API-Preise und -Limits

Gute Nachrichten: Jeder Zendesk-Plan beinhaltet API-Zugriff. Es fallen keine zusätzlichen Gebühren für die Nutzung der API an, obwohl Pläne höherer Stufen höhere Ratenbegrenzungen erhalten.

Wenn Sie mehr als 700 Anfragen pro Minute benötigen, erhöht das High Volume API-Add-on das Limit auf 2.500 Anfragen pro Minute. Es ist ab Suite Growth und höher sowie Support Professional und höher mit mindestens 10 Agent-Plätzen verfügbar.

Weitere zu beachtende Einschränkungen:

• Die Paginierung gibt maximal 100 Datensätze pro Seite zurück
• Die Suche gibt maximal 1.000 Ergebnisse pro Abfrage zurück
• Massenoperationen verarbeiten maximal 100 Datensätze pro Anfrage
• Sie können bis zu 30 Hintergrundjobs gleichzeitig in die Warteschlange stellen

Quelle: Zendesk Preise

Wann die Zendesk API vs. No-Code-Alternativen verwenden

Die API ist leistungsstark, aber nicht immer das richtige Werkzeug für den Job. So entscheiden Sie.

Wann die API sinnvoll ist

• Komplexe Integrationen: Sie müssen Zendesk mit proprietären Systemen oder benutzerdefinierten Anwendungen verbinden
• Massendatenoperationen: Sie migrieren Tausende von Datensätzen oder benötigen regelmäßige Datenexporte
• Benutzerdefinierte Berichterstellung: Sie benötigen Analysen, die die integrierten Dashboards von Zendesk nicht bieten
• Workflow-Automatisierung: Sie möchten komplexe, mehrstufige Prozesse über mehrere Systeme hinweg auslösen

Wann No-Code-Tools besser sind

• Einfache Automatisierungen: Routing-Regeln, automatische Antworten und grundlegende Ticketbearbeitung
• Kleine Teams: Sie verfügen nicht über Entwicklerressourcen, um API-Integrationen zu erstellen und zu warten
• Schnelle Einrichtung: Sie brauchen etwas, das heute funktioniert, nicht im nächsten Sprint
• KI-gestützter Support: Sie möchten einen KI-Agenten, der Tickets ohne Programmieren bearbeiten kann

Hier kommen wir ins Spiel. eesel AI arbeitet als KI-Teamkollege innerhalb von Zendesk. Es lernt aus Ihren vergangenen Tickets und dem Help Center und bearbeitet dann den Frontline-Support autonom. Keine API-Programmierung erforderlich. Sie beginnen damit, dass eesel Entwürfe für Antworten zur Überprüfung erstellt, und steigen dann zur vollständigen Automatisierung auf, sobald es sich bewährt hat.

Die API und KI-Agenten schließen sich nicht gegenseitig aus. Viele Teams verwenden beides: die API für Datenintegrationen und benutzerdefinierte Workflows und KI-Agenten für die Bearbeitung routinemäßiger Kundenkonversationen.

Beginnen Sie noch heute mit der Automatisierung Ihres Zendesk-Workflows

Die Zendesk API gibt Ihnen programmatische Kontrolle über Ihren Support-Betrieb. Egal, ob Sie Massendaten importieren, benutzerdefinierte Integrationen erstellen oder automatisierte Workflows erstellen, die API hat die Endpunkte, die Sie benötigen.

Wichtige Erkenntnisse:

• API-Token sind der schnellste Weg, um zu beginnen; OAuth ist besser für Multi-Kunden-Apps
• Die Ratenbegrenzungen reichen von 200 bis 2.500 Anfragen pro Minute, abhängig von Ihrem Plan
• Die Such-API enthält archivierte Tickets, die UI-Ansichten verpassen
• Massenoperationen verarbeiten bis zu 100 Datensätze pro Anfrage

Wenn Sie nach Automatisierung ohne Entwicklungsarbeit suchen, laden Sie eesel AI in Ihr Team ein. Unser KI-Agent integriert sich direkt in Zendesk, lernt Ihr Geschäft in wenigen Minuten aus Ihren vorhandenen Tickets und Dokumenten und kann bis zu 81 % Ihres Frontline-Supports autonom bearbeiten. Sie steuern den Umfang, überprüfen die Leistung, bevor Sie live gehen, und skalieren hoch, sobald sich eesel bewährt hat.

Egal, ob Sie den API-Weg oder einen KI-gestützten Ansatz wählen, das Ziel ist dasselbe: weniger manuelle Arbeit, schnellere Antworten und bessere Kundenerlebnisse.