Agile Developer Hilfe-Center › Agile CRM

Wie lege ich in Agile CRM einen API-Schlüssel oder Webhook an?

API und Integrationen: Schlüssel mit Name, Gültigkeit und Rechten anlegen (agile_crm_…, nur einmal sichtbar). Webhooks für Admins, signiert mit HMAC-SHA256. Doku unter /docs.

Mit der REST-API verbinden Sie Agile CRM mit Website-Formularen, anderer Software oder Automationen. Die Dokumentation mit allen Endpunkten finden Sie unter https://crm.agiledeveloper.de/docs.

API-Schlüssel anlegen

  1. Öffnen Sie in der Seitenleiste API und Integrationen.
  2. Geben Sie im Abschnitt API-Schlüssel einen Name ein (z. B. Website-Formular).
  3. Wählen Sie unter Gültig: unbegrenzt (bis zum Widerruf), 30 Tage, 90 Tage oder 1 Jahr.
  4. Legen Sie die Rechte je Bereich fest (Kein, Lesen, Schreiben): Leads, Aktivitäten, Aufgaben; Pipelines und Zielgruppen; Auswertungen; KI-Funktionen; Team; Guthaben; Webhooks.
  5. Klicken Sie auf Schlüssel anlegen. Der Schlüssel beginnt mit agile_crm_ und wird nur dieses eine Mal angezeigt. Kopieren Sie ihn und legen Sie ihn sicher ab.

Senden Sie ihn im Kopf Authorization: Bearer agile_crm_…. Mit Widerrufen machen Sie einen Schlüssel sofort ungültig. Admins sehen alle Schlüssel des Workspace, andere Personen nur ihre eigenen. Pro Zugang sind 120 Anfragen je Minute möglich.

Webhooks

Webhooks melden Ereignisse sofort an Ihr System. Inhaber und Admins legen sie im Abschnitt Webhooks an: Adresse (https), optional eine Beschreibung und die gewünschten Ereignisse, dann Webhook anlegen.

Ereignisse: lead.angelegt, lead.geaendert, lead.geloescht, lead.phase_geaendert, aufgabe.faellig, recherche.fertig, guthaben.niedrig.

Jede Zustellung ist signiert (Kopf Agile-Signature, HMAC-SHA256). Fehlgeschlagene Zustellungen wiederholen wir bis zu 12 Stunden lang. Je Webhook gibt es Testen, Protokoll, Geheimnis zeigen, Erneuern, Aus- und Einschalten und Löschen.

Für Claude oder ChatGPT brauchen Sie keinen Schlüssel, dafür gibt es die Anmeldung per MCP.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 11. Oktober 2026

Weitere Artikel zu Agile CRM

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.