API Keys und Webhooks einrichten

Nutze API Keys und Webhooks, wenn externe Systeme Leads, Integrationen oder Automationen mit Pragma verbinden sollen.

Voraussetzungen

Du bist Owner oder Master im Workspace.
Der Workspace ist aktiv und nicht durch eine abgelaufene Trial gesperrt.
Für Webhooks hast du eine HTTPS-Ziel-URL, die POST-Requests entgegennehmen kann.

Öffne in der App Platform & API.
Wechsle zu API-Schlüssel.
Klicke Neuer API-Schlüssel.
Vergib einen sprechenden Namen, zum Beispiel Zapier Lead Import oder Backend Sync.
Wähle nur die Scopes, die das System wirklich benötigt.
Erstelle den Key und kopiere den Token sofort. Er wird nur einmal angezeigt.

Beispiel für Server-zu-Server-Aufrufe:

curl https://app.mikemuellers.de/api/leads \
  -H "Authorization: Bearer <dein-api-key>"

Öffne Platform & API.
Wechsle zu Webhooks.
Trage die Ziel-URL ein.
Wähle die Events, die dein System braucht, zum Beispiel lead.created oder crm.synced.
Speichere den Webhook.
Sende eine Test-Delivery und prüfe im Zielsystem, ob der Request ankommt.

Event	Wann es ausgelöst wird
`lead.created`	Ein Lead wurde per UI, CSV oder API erstellt
`lead.updated`	Lead-Felder oder Stage wurden geändert
`lead.scored`	AI-Score wurde berechnet
`followup.created`	Eine Follow-up-Aufgabe wurde erstellt
`crm.synced`	Ein Lead wurde mit HubSpot, Pipedrive oder Salesforce synchronisiert
`integration.installed`	Eine Marketplace-Integration wurde verbunden

401: Token fehlt oder ist falsch formatiert. Prüfe den Header Authorization: Bearer ....
403: Der Key oder User hat nicht genug Rechte.
423: Workspace ist gesperrt, meist wegen abgelaufener Trial.
Webhook kommt nicht an: Prüfe HTTPS, Firewall, Statuscodes und ob deine Ziel-URL schnell genug antwortet.

Öffne die interaktive Referenz unter Swagger UI oder lade die Spezifikation über OpenAPI JSON.