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
- Öffnen Sie in der Seitenleiste API und Integrationen.
- Geben Sie im Abschnitt API-Schlüssel einen Name ein (z. B. Website-Formular).
- Wählen Sie unter Gültig: unbegrenzt (bis zum Widerruf), 30 Tage, 90 Tage oder 1 Jahr.
- Legen Sie die Rechte je Bereich fest (Kein, Lesen, Schreiben): Leads, Aktivitäten, Aufgaben; Pipelines und Zielgruppen; Auswertungen; KI-Funktionen; Team; Guthaben; Webhooks.
- 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.