Um ClickUp-Daten mit externen Apps zu teilen, kannst du zwei Arten von Webhooks in ClickUp verwenden:

1. Webhooks, die über die ClickUp Public API erstellt werden.
2. Webhooks, die durch Automatisierungen ausgelöst werden.

Verfügbarkeit und Limits von Funktionen variieren je nach Plan und Benutzerrolle. Mehr erfahren

API-Webhooks

Nutze API-Webhooks, wenn du umfassend alle Erstell-, Aktualisierungs- und Löschereignisse für Aufgaben, Listen, Unterordner, Ordner, Spaces, Ziele und Targets verfolgen möchtest.

Erfahre mehr über ClickUp-API-Webhooks, zum Beispiel:

• Sieh dir Beispiel-Payloads an.
• Lies die Spezifikation für die Webhook-Endpunkte der ClickUp Public API.
• Sende deine erste Webhook-erstellen-Anfrage direkt aus dem Browser.

Automatisierungs-Webhooks

Nutze Automatisierungs-Webhooks, wenn du die vollständige Kontrolle über die Trigger und Bedingungen haben möchtest, die deine Daten an externe Apps senden.

Es gibt zwei Arten von Automatisierungs-Webhooks, die du in ClickUp erstellen kannst:

• Aufgaben-Webhooks: Senden Daten, wenn Aufgaben aktualisiert werden.
• Chat-Webhooks: Senden Daten, wenn Chat-Nachrichten gepostet werden.

Webhook erstellen

Du musst für jedes Ziel, das ClickUp-Daten aus Automatisierungen empfangen soll, einen Webhook erstellen.

Du kannst in Automatisierungen erstellte Webhooks in deinem gesamten Workspace wiederverwenden, musst aber separate Webhooks für Aufgaben- und Chat-Automatisierungen konfigurieren.

Teste deinen Webhook, bevor du ihn zu Automatisierungen hinzufügst, die echte Daten senden.

Dynamische Variablen im Webhook verwenden

Dynamische Variablen in der URL helfen deiner App dabei, die von ClickUp empfangenen Daten effizient zu verarbeiten.

Du kannst dynamische Variablen in der URL deines Webhooks verwenden, z. B. die Aufgaben-ID.

Header verwenden

Header können Metadaten enthalten, die es deiner App ermöglichen, eingehende Webhook-Payloads sicher und korrekt zu verarbeiten. Standardmäßig fügt ClickUp den folgenden Header hinzu:

Content-type: application/json

URL-Parameter verwenden

Du kannst für jeden Webhook auch URL-Parameter festlegen, die deiner App helfen, Daten korrekt zu verarbeiten.

Anders als dynamische Variablen sind URL-Parameter statisch. Die Werte ändern sich nicht, wenn deine Automatisierung ausgelöst wird.

Webhooks testen

Wenn du Webhooks zum ersten Mal verwendest, empfehlen wir dir, sie zu testen, bevor du echte Daten aus deinem ClickUp-Workspace sendest.

Es gibt kostenlose Online-Tools zum Testen und Ausprobieren von Webhooks. Du kannst zum Beispiel webhook.site nutzen, um eine Webhook-URL zu generieren und die von ClickUp gesendeten Webhook-Payloads einzusehen.

Für API-Webhooks:

• Filtere deinen ersten Webhook auf bestimmte Ereignisse, z. B. taskCreated und taskUpdated.
• Filtere deinen ersten Webhook auf einen bestimmten Speicherort, z. B. eine dedizierte Liste, die nur Testaufgaben mit generischen, aber repräsentativen Daten enthält.

Für Automatisierungs-Webhooks:

• Setze präzise Trigger und Bedingungen ein, z. B. ein benutzerdefiniertes Feld vom Typ Kontrollkästchen, um zu steuern, wann Daten gesendet werden.
• Füge die Automatisierung zunächst einer bestimmten Liste oder einem bestimmten Kanal hinzu – mit generischen, aber repräsentativen Aufgaben und Nachrichten.