n8n-Webhook-Node auf Customermates-Events abonnieren, HTTP-Request-Node mit API-Key für Writes zurück. Kein Custom-Node nötig. Die REST- und MCP-Oberflächen funktionieren direkt.
Wann n8n passt
- Dein Team bevorzugt visuelle Flows gegenüber Code.
- Du willst Events branchen und transformieren, bevor sie weiterlaufen (Slack, HubSpot, Google Sheets, Warehouse).
- Du betreibst n8n ohnehin für andere Automationen.
Wenn eine KI das CRM im Gespräch fahren soll: MCP stattdessen oder parallel.
Pattern 1: n8n aus CRM-Änderungen triggern
- In n8n: Webhook-Node hinzufügen. Die generierte URL kopieren.
- In Customermates: Unternehmen → Webhooks → Neu und URL einfügen. Events wählen.
- Nach dem Webhook-Node Schritte zum Transformieren und Weiterleiten.
Payload-Shape dokumentiert unter Webhooks. Typische nächste Schritte:
- Slack: "neuer Deal: $[Betrag]" in einen Channel.
- Google Sheets: Zeile anhängen bei jedem neuen Contact.
- HubSpot: Contact mirrored.
Pattern 2: aus n8n nach Customermates pushen
HTTP Request-Node:
- Method:
POST (oder PATCH für Updates)
- URL:
https://customermates.com/api/v1/<endpoint>
- Headers:
x-api-key als n8n-Credential gesetzt
- Body: JSON gemäß OpenAPI-Spec
Für MCP-Style-Tool-Calls aus n8n auf /api/v1/mcp mit method: "tools/call". Nützlich, wenn n8n dieselben Guardrails will (Null-Wipe-Rejection, Type-Mismatch-Routing).
Pattern 3: Scheduled Cleanup
n8n Cron-Trigger plus Customermates-REST:
- Täglich: Contacts ohne Organization finden, Reminder posten.
- Wöchentlich: Won-Deals der letzten Woche in Google Sheet.
- Monatlich: Lost-Deals älter als 90 Tage archivieren.
Authentifizierung
API-Key als n8n-Header-Auth-Credential mit Name x-api-key speichern. Über Nodes wiederverwenden. An einer Stelle rotieren.
Typische Fallstricke
- Null-Wipe-Guard:
null auf Relationship-Array wird abgelehnt. [] oder link_entities / unlink_entities nutzen.
- Rate-Limits: High-Frequency-Loops laufen in Limits. Wenn möglich batchen.
- Webhook-Ordering: Deliveries nicht strikt geordnet. Als idempotente Messages per
entityId behandeln.
Weiter
- Webhooks: die Trigger-Seite im Detail.
- OpenAPI: volle REST-Referenz für die Action-Seite.
- MCP: wenn KI im Loop sein soll.
