CRM API
Lassen Sie Ihren KI-Agenten und Ihre Tools aus denselben Kundendatensätzen nachfassen
Ihr KI-Client liest den Datensatz eines Kunden und aktualisiert den nächsten Schritt über MCP. Ihre anderen Systeme lesen und schreiben dieselben Datensätze über REST und signierte Webhooks. Dieselben Rechte; REST und MCP in jedem Tarif, Webhooks in bezahlten Tarifen und selbst gehostet.
✓ Keine Kreditkarte benötigt ✓ Erste 14 Tage kostenlos
So funktioniert es
Alles, was Ihr Nachfassen braucht, an einem Ort. Vier Teile, die zusammenarbeiten.
Ihr Wissen, Ihre Kundendaten und Ihre Gespräche liegen zusammen, damit jeder Agent, der Ihnen hilft, mit denselben Fakten arbeitet.
Agenten
Jeder Tarif, Mate in bezahlter CloudMate ist eingebaut. Oder verbinden Sie die KI, für die Sie schon bezahlen, und sie arbeitet mit denselben Daten und Regeln.
Posteingang
Cloud, ab ProE-Mail und LinkedIn, dazu WhatsApp, Instagram und Telegram, direkt beim Kunden, zu dem das Gespräch gehört.
Daten
Jeder TarifKunden, Deals und jede Liste, die Ihr Geschäft braucht, mit eigenen Feldern, Phasen und Ansichten.
Wissen
Jeder TarifLeitfäden, Preise und Ihre Arbeitsweise, einmal aufgeschrieben. Mate und verbundene Agenten nutzen die Seiten, die ihre Rechte erlauben.
Aus einer einzigen Beschreibung
Eine Beschreibung. Ein Workspace, den Ihr Agent gebaut hat.
Das baut die Einrichtung aus einem Satz. Beispieldaten, das echte Produkt.
Beschreiben Sie Ihr Geschäft
Ein Satz zu Ihrem Team, Ihren Kunden und wie Sie verkaufen.
Mate baut den Workspace
Die KI stellt ein paar Fragen und legt Listen, Pipeline, Dashboard und Leitfaden an.
Arbeiten Sie darin
Verbinden Sie LinkedIn und E-Mail. Unten können Sie ein fertiges Beispiel ausprobieren.
Wir sind eine Strategieberatung mit vier Personen. Verwalte Kunden, Mandate und Angebote und hilf uns, Interessenten auf LinkedIn nachzufassen.
Widgets aus den eigenen Listen und Feldern des Workspace
So können Sie es nutzen
Wählen Sie die Aufgabe. Der Workspace passt sich an.
- LinkedIn-Gespräche nachfassenLinkedIn- und E-Mail-Verläufe liegen beim Kunden. Mate entwirft die Antwort und terminiert den nächsten Schritt, und Sie prüfen und senden die Antwort im Gespräch.Zu LinkedIn im Posteingang
- Jedes Angebot nach dem Termin nachfassenKunden, Mandate und Angebote mit den Gesprächen dahinter und einem terminierten nächsten Schritt bei jedem.CRM für Berater
- Nächste Schritte auf einem DashboardJeder Kunde bekommt einen terminierten nächsten Schritt, und Ihr Dashboard zeigt, was über alle Kunden fällig ist.Zum Nachfassen
- Claude oder ChatGPT in Ihrem CRM arbeiten lassenVerbinden Sie Claude, ChatGPT, Cursor oder einen anderen MCP-Client. Er liest und pflegt Ihren Workspace im Rahmen Ihrer Rechte.Agenten verbinden
So funktioniert es
CRM API in 5 Schritten.
- 01
Key anlegen
Öffnen Sie Einstellungen → API-Schlüssel, klicken Sie auf Hinzufügen, wählen Sie Standard-API-Key, vergeben Sie einen Namen wie ERP-Sync, Produktion und kopieren Sie den Key. Er wird nur einmal angezeigt.
- 02
Schema laden
Rufen Sie /api/v1/openapi unter Ihrer Workspace-Adresse ab und importieren Sie das Dokument in Postman, Insomnia oder einen Client-Generator.
- 03
Abfragen
Senden Sie POST /api/v1/records/query mit dem Header x-api-key. Die Antwort enthält alle Deals, die in den letzten sieben Tagen geändert wurden.
- 04
Schreiben
Setzen Sie einen Deal mit POST /api/v1/records/mutate in eine andere Phase. Was Ihr Nutzer in der App darf, darf der Key auch über die API.
- 05
Abonnieren
Legen Sie einen Webhook für Datensatz aktualisiert auf der Liste Deals mit Secret an, richten Sie ihn auf Ihren Endpunkt und prüfen Sie die erste Zustellung unter Zustellungen.
Im Produkt
Auf einen Blick
Schnittstellen
REST unter /api/v1, OpenAPI-3.1-Spezifikation, 16 Webhook-Events und 59 MCP-Tools.
Tarife
REST und MCP in jedem Cloud-Tarif, Webhooks in jedem bezahlten Tarif, alle drei beim Self-Hosting. Inbox-Endpunkte brauchen ein verbundenes Konto, das in Customermates Cloud ab Pro verfügbar ist.
Authentifizierung
Ein API-Key pro Client im Header x-api-key. Ein Key hat genau die Rechte der Rolle seines Besitzers.
Grenzen
Bulk-Schreibvorgänge nehmen bis zu 100 Datensätze pro Anfrage. Kein ODER zwischen Filterregeln, keine Scopes pro Key.
Customermates ist ein CRM mit offener REST-Schnittstelle in jedem Tarif, ab Starter für 12 € pro Nutzer und Monat, und in der kostenlosen selbst gehosteten Version. Sie authentifizieren sich mit einem API-Key im Header x-api-key, das vollständige Schema liegt als OpenAPI-3.1-Dokument unter /api/v1/openapi, und in bezahlten Tarifen und selbst gehostet melden 16 Webhook-Events Ihren Systemen jede Änderung. Einen eigenen Entwicklertarif oder ein kostenpflichtiges API-Add-on gibt es nicht.
Customermates ist ein Open-Source-KI-CRM aus Deutschland für kleine Teams mit viel Kundenkontakt. Die API ist für zwei Gruppen interessant: Entwickler, die das CRM mit ERP, Buchhaltung oder Data-Warehouse verbinden wollen, und Teams, die einen KI-Client wie Claude oder ChatGPT Datensätze pflegen lassen wollen. Die erste Gruppe nutzt REST und Webhooks, die zweite den MCP-Endpunkt. Beide laufen über dieselben Berechtigungen.
Warum das für das Nachfassen zählt. Eine Kundenantwort geht unter, wenn die Fakten, die man dafür braucht, in einem anderen System liegen. Über MCP liest Ihr eigener KI-Client, etwa Claude oder ChatGPT, den Datensatz eines Kunden und in Customermates Cloud ab Pro auch die Gespräche mit ihm und kann einen Antwortentwurf speichern, den Sie prüfen und senden. Über REST und Webhooks bekommen Ihre anderen Tools dieselben Datensätze und erfahren, wenn sich einer ändert.
Was die REST-API abdeckt
Die REST-API arbeitet mit jeder Liste des CRM. Ein neuer Workspace startet ohne Listen: Sie legen die benötigten Listen (Kontakte, Organisationen, Deals oder eigene) unter Datenmodell, per API oder MCP an, oder die KI-Einrichtung baut sie in der Cloud. Jede Datensatz-Route ist ein POST an eine benannte Aktion mit JSON-Body. Derselbe Code funktioniert also für Deals, Kontakte oder eine Liste, die Sie letzte Woche angelegt haben.
| Ziel | Methode und Pfad |
|---|---|
Listen und ihre typeId finden | POST /api/v1/model/discover |
| Felder, Beziehungen, Options-IDs und Schema-Revision lesen | POST /api/v1/model/read |
| Eine Liste filtern, sortieren und blättern | POST /api/v1/records/query |
| Listenübergreifend nach Text suchen | POST /api/v1/records/search |
| Einen Datensatz lesen | POST /api/v1/records/read |
| Anlegen, ändern, löschen, verknüpfen oder Verknüpfung lösen | POST /api/v1/records/mutate |
| Bis zu 100 Datensätze ändern oder löschen | POST /api/v1/records/mutate mit updateMany oder deleteMany |
| Eine Liste exportieren oder bis zu 100 Datensätze importieren | POST /api/v1/records/export oder POST /api/v1/records/import |
| Eine Datei in ein Feld vom Typ Datei hochladen | POST /api/v1/files/uploads, dann POST /api/v1/records/mutate |
| Ein Feld summieren oder zählen, etwa den Pipeline-Wert | POST /api/v1/reports/query |
Ein Datensatz wird über eine Referenz adressiert, { "typeId": "...", "recordId": "..." }, nicht über seine URL. Die Basis-URL ist die Adresse, unter der Sie Customermates öffnen, in der Cloud wie auf dem eigenen Server. Weitere Routen gibt es für Nutzer (/api/v1/users/me, /api/v1/users/search), für Webhooks und für die Inbox: Threads, Entwürfe, Versand von E-Mails und Chatnachrichten, Aktivitäten und lesender Kalenderzugriff.
Fünf Details sparen beim Einstieg Zeit:
- Felder haben stabile IDs.
/model/readliefert diefieldIdjedes Felds, die Options-IDs eines Einzelauswahl-Felds wie der Deal-Phase und die Schema-revision. Die IDs bleiben gleich, wenn jemand eine Liste oder ein Feld umbenennt. Werte sind typisiert, zum Beispiel{ "kind": "text", "value": "Acme" }. - Abfragen erwarten einen JSON-Body.
/records/querynimmttypeId,filters,sort,pageundpageSize(bis 500). Filter folgen der Filtersyntax, die auch App und MCP verwenden. - Schreibvorgänge sind abgesichert. Eine Mutation enthält
expectedRevision(die Schema-Revision), einenidempotencyKeyund die eigentlichemutation; Änderungen und Löschungen enthalten zusätzlich dieexpectedVersiondes Datensatzes. Wer dieselbe Anfrage mit demselben Key erneut sendet, führt sie nicht doppelt aus. - Verknüpfungen sind eine eigene Aktion.
linkundunlinknehmen einerelationId, einesourceund eintargetals Datensatzreferenz. Eine Änderung entfernt nie Verknüpfungen, die Sie nicht genannt haben. - Bulk-Schreibvorgänge nehmen bis zu 100 Datensätze.
updateManywendet eine Änderung atomar auf bis zu 100 Datensätze an,deleteManyverschiebt bis zu 100 in den Papierkorb. Eine Bereinigung von 2.000 Kontakten teilen Sie also in 20 Anfragen auf.
Webhooks: Das CRM meldet sich bei Ihnen
Ein Webhook schickt einen JSON-POST an Ihre URL, sobald ein abonniertes Ereignis eintritt. Admins und Mitglieder, deren Rolle in der Zeile API & Webhooks Lesen Alle und Erstellen hat, legen ihn unter Einstellungen → Webhooks an: URL, Events, die Liste unter Datensätze aus mit optionalen Filtern, optional ein Secret, eigene Header und eine Body-Vorlage. Die Webhook-Referenz listet jedes Event mit Payload.
- Events: 5 Datensatz-Events (
record.created,record.updated,record.deletedbeim Verschieben in den Papierkorb,record.restoredundrecord.deletedPermanently) für jede gewählte Liste, auch Ihre eigenen, und 11 Inbox- und Kalender-Events. - Änderungen inklusive: Ein
record.updated-Payload enthält die Datensatzreferenz und jedes geänderte Feld mit seinem Wertbeforeundafter. Ein Schreibvorgang ohne Änderung löst kein Event aus. - Signatur: Mit gesetztem Secret wird jede Zustellung per HMAC-SHA256 über den Roh-Body signiert.
- Wiederholungen: Bei Timeout, Netzwerkfehler, 5xx, 408, 425 oder 429 wird automatisch wiederholt, mit bis zu 10 Versuchen insgesamt. Andere 4xx-Antworten werden nicht wiederholt, weil ein zweiter Versuch genauso scheitern würde. Jede Zustellung hat 5 Sekunden Timeout.
- Zustellprotokoll: Unter Einstellungen → Webhook-Protokoll sehen Sie Statuscode und Antworttext jeder Zustellung und können sie erneut senden.
- Body-Vorlagen: Eine Vorlage ersetzt das Standardformat der Zustellung. So nimmt ein Chat-Tool oder Automatisierungsendpunkt mit eigenem JSON-Format die Daten direkt an, ohne Middleware dazwischen.
Zustellungen kommen nicht garantiert in Reihenfolge an. Zwei Änderungen am selben Kontakt im Abstand weniger Millisekunden können vertauscht eintreffen. Deduplizieren Sie deshalb anhand der Event-id, ordnen Sie über typeId und recordId zu und nutzen Sie timestamp und Datensatzversion im Payload.
So senden Sie den ersten API-Aufruf
Key anlegen
Öffnen Sie Einstellungen → API-Schlüssel & Konnektoren, klicken Sie auf Hinzufügen, wählen Sie Standard-API-Key, vergeben Sie einen Namen wieERP-Sync, Produktionund kopieren Sie den Key. Er wird nur einmal angezeigt. Ablauf und Rotation erklärt die Anleitung zu API-Keys.Schema laden
Rufen Sie/api/v1/openapiunter Ihrer Workspace-Adresse ab und importieren Sie das Dokument in Postman, Insomnia oder einen Client-Generator. Senden Sie danachPOST /api/v1/model/discovermit{"search":"deal"}, um dietypeIdIhrer Deals zu erhalten, undPOST /api/v1/model/readmit{"typeIds":["<deal-type-id>"]}, um Felder, Phasen-Optionen und Schema-revisionzu sehen.Abfragen
Senden SiePOST /api/v1/records/querymit dem Headerx-api-keyund einem Body wie{"typeId":"<deal-type-id>","filters":[{"fieldId":"system:updatedAt","operator":"inLastDays","value":{"kind":"decimal","value":"7","currency":null}}],"page":1,"pageSize":25}. Die Antwort enthält alle Deals, die in den letzten sieben Tagen geändert wurden.Schreiben
Setzen Sie einen Deal mitPOST /api/v1/records/mutatein eine andere Phase:{"expectedRevision":<revision>,"idempotencyKey":"move-acme-to-demo","mutation":{"action":"update","ref":{"typeId":"<deal-type-id>","recordId":"<deal-id>"},"expectedVersion":<version>,"fields":[{"fieldId":"<stage-field-id>","value":{"kind":"select","value":"<option-id>"}}]}}. Was Ihr Nutzer in der App darf, darf der Key auch über die API.Abonnieren
Legen Sie einen Webhook für Datensatz aktualisiert auf der Liste Deals mit Secret an, richten Sie ihn auf Ihren Endpunkt und prüfen Sie die erste Zustellung unter Webhook-Protokoll.
Ein falscher, abgelaufener oder gelöschter Key erhält HTTP 401. Ein Key, dessen Besitzer auf Inaktiv steht, erhält 403.
API-Keys und Berechtigungen
Keys gehören dem Nutzer, der sie angelegt hat, und handeln mit dessen aktueller Rolle. Eigene API-Nutzer oder Scopes pro Key gibt es nicht, ein Key lässt sich also nicht auf Lesezugriff beschränken. Soll eine Integration nur Deals lesen, legen Sie ihren Key unter einem Mitglied an, dessen Rolle genau das erlaubt. In Customermates Cloud wird dieses Mitglied wie jeder andere Nutzer abgerechnet.
Zum Anlegen von Keys braucht eine Rolle in der Zeile API & Webhooks Lesen Alle und Erstellen. Eine neue eigene Rolle hat das nicht, standardmäßig legen also nur Admins Keys an. Dieselbe Berechtigung öffnet auch alle Webhooks des Workspace, was Sie vor der Vergabe wissen sollten. Verlässt jemand das Team, setzen Sie das Mitglied auf Inaktiv. Auch der Entzug von Lesen Alle auf API & Webhooks stoppt seine Keys.
MCP: die Schnittstelle für KI-Clients
Der MCP-Endpunkt unter /api/v1/mcp gibt einem externen KI-Client 59 Tools für dieselben Datensätze, die Inbox und die Webhooks. Claude und ChatGPT verbinden sich per OAuth als benutzerdefinierter Konnektor, Claude Code, Codex, Cursor und Gemini nutzen einen API-Key. Client, Modell und Abonnement wählen Sie selbst. Semantische Suche kann in Customermates Cloud trotzdem das Mate-Kontingent beanspruchen. Alle Tools stehen im MCP-Leitfaden.
Mate, der Assistent in Customermates Cloud, ist eine eigene Funktion. Er nutzt gehostete KI-Credits und braucht keinen API-Key. Selbst gehostete Installationen haben MCP, aber kein Mate.
Was die API nicht kann
- Kein PUT oder PATCH auf Datensätzen. Jede Änderung ist ein
POSTan/api/v1/records/mutate. - Kein ODER zwischen Filterregeln. Filterregeln werden mit UND verknüpft. Für ODER führen Sie zwei Abfragen aus oder nutzen den Operator
inauf einem Feld. - Keine veröffentlichte Anfragequote. Ein ausgelasteter Workspace antwortet mit
429und einemRetry-After-Header. Teilen Sie Bulk-Jobs in Stapel zu 100 auf. - Kein CSV-Export-Endpunkt und kein Export des gesamten Kontos. Die App importiert Excel-, CSV- und JSON-Dateien und exportiert XLSX und JSON, jeweils eine Liste. Größere Mengen laufen über Ihr eigenes API-Skript.
- Keine Inbox und kein Mate beim Self-Hosting. REST-Routen für Datensätze, Webhooks und MCP funktionieren dort, die Messaging-Routen brauchen Customermates Cloud ab Pro.
Über den Pfad /api/v1 hinaus wird keine feste Kompatibilitätsfrist zugesagt. Behandeln Sie das aktuelle OpenAPI-Dokument als Vertrag und testen Sie dagegen.
Wie andere CRMs den API-Zugang begrenzen
Diese Seite wird von Customermates veröffentlicht. Die Angaben stammen aus der Dokumentation der jeweiligen Anbieter, geprüft am 8. Oktober 2026. Sie ändern sich, folgen Sie daher den Links, bevor Sie damit planen.
| CRM | API im kostenlosen oder Einstiegstarif | Wie die Nutzung begrenzt wird |
|---|---|---|
| HubSpot | Ja | Private Apps in Free und Starter: 100 Anfragen pro 10 Sekunden und 250.000 täglich pro Konto, mehr in Professional und Enterprise |
| Pipedrive | Jeder Tarif enthält ein API-Token | Tägliches Token-Budget: 30.000 Basis-Tokens mal Tarif-Multiplikator mal Nutzerlizenzen |
| Zoho CRM | Ja, auch in der Free Edition | Credits pro 24 Stunden: 5.000 in Free, in bezahlten Editionen mehr pro Nutzer |
| EspoCRM | Ja, auch in der kostenlosen selbst gehosteten Version | API-Key, HMAC oder Basic Auth über eigene API-Nutzer, deren Rollen die Rechte festlegen |
| Customermates | Jeder Tarif und Self-Hosting | Keine veröffentlichte Quote, Bulk-Routen nehmen 100 Datensätze pro Anfrage |
HubSpot oder Zoho CRM passen, wenn Sie einen kostenlosen Cloud-Tarif mit API-Zugang suchen und Ihre Integration mit den veröffentlichten Aufruflimits auskommt. Pipedrive passt, wenn ein Tagesbudget, das mit Tarif und Nutzerzahl wächst, zu Ihrem Volumen passt. EspoCRM passt, wenn Sie ein selbst gehostetes Open-Source-CRM mit getrennten API-Nutzern und eigenen Rollen wollen. Customermates passt zu einem kleinen Team, das Datensatz-API, Webhooks und einen MCP-Endpunkt für KI-Clients zum Preis des CRM selbst haben möchte, mit einem AGPL-Kern, den es selbst hosten kann. Es passt nicht, wenn Sie Scopes pro Key brauchen oder, in Customermates Cloud, einen API-Nutzer ohne kostenpflichtige Lizenz.
Was es kostet
Für den API-Zugang gibt es keinen Aufpreis. Ein Team mit drei Personen zahlt in Starter 36 € pro Monat und erhält REST, Webhooks und MCP. Dasselbe Team zahlt in Pro 87 € und bekommt die Unified Inbox samt Messaging-Routen dazu. Die selbst gehostete Open-Source-Version kostet keine Lizenzgebühr, den Server betreiben Sie selbst. Abgerechnet wird monatlich, Details unter Preise. Wenn Sie Abläufe in n8n bauen: n8n ist ein eigenes Produkt mit eigenen Tarifen, die n8n-Anleitung zeigt die Einrichtung mit HTTP-Request-Nodes.
Was ist eine API im CRM, einfach erklärt?
Eine API ist der programmatische Zugang zu den Daten des CRM. Ein anderes Programm sendet HTTP-Anfragen, um Kontakte, Deals und andere Datensätze zu lesen, anzulegen, zu ändern oder zu löschen, statt dass jemand sich durch die Oberfläche klickt. Webhooks sind die Gegenrichtung: Das CRM ruft Ihr Programm auf, wenn sich Daten ändern.
Ist die API kostenlos?
In Customermates ist sie in jedem Tarif ohne Aufpreis enthalten und in der selbst gehosteten Version ohne Lizenzkosten nutzbar. Bei anderen Anbietern hängt das am Tarif: Pipedrive, HubSpot und Zoho CRM bieten API-Zugang auch im Einstiegstarif, begrenzen aber die Zahl der Aufrufe je nach Tarif. EspoCRM hat eine kostenlose selbst gehostete Version mit REST-API.
Welches CRM hat die beste API?
Das hängt vom Projekt ab. Prüfen Sie vier Punkte: ob die API im Tarif enthalten ist, den Sie tatsächlich kaufen, wie Aufrufe gezählt werden, ob Webhooks die Änderungen mitliefern und ob es eine maschinenlesbare Spezifikation gibt. Für ein kleines Team zählen API im Einstiegstarif, OpenAPI-Dokument und signierte Webhooks meist mehr als die Länge des Endpunktkatalogs.
Kann ich einen API-Key auf Lesezugriff beschränken?
Nein. Ein Key hat genau die Rechte des Nutzers, dem er gehört. Soll eine Integration nur lesen, legen Sie den Key unter einem Mitglied mit eingeschränkter Rolle an.
Deckt die API auch die Inbox ab?
Ja, in Customermates Cloud ab Pro, wenn Nutzer E-Mail, LinkedIn, WhatsApp, Instagram oder Telegram verbunden haben. Die Routen umfassen Threads, Entwürfe, den Versand von E-Mails und Chatnachrichten sowie Aktivitäten. Jede Anfrage sendet eine Nachricht, einen Massenversand gibt es nicht.
Brauche ich n8n oder Zapier für die API?
Nein. Jede Sprache, die HTTPS-Anfragen senden kann, funktioniert. n8n ist optional und läuft separat. Die Übersicht der Integrationen vergleicht REST, Webhooks, MCP und n8n, zum Self-Hosting finden Sie mehr unter Self-Hosting.
Verwandte Seiten
API-Keys für MCP- und REST-Clients
API-Key in den Einstellungen anlegen: nötige Rollenberechtigung, Header x-api-key, Ablauf von Keys sowie Löschen und Rotieren eines Keys.
Webhooks: Signaturen, Retries und Event-Katalog
CRM-Events abonnieren, Signaturen verifizieren, fehlgeschlagene Zustellungen prüfen und den vollständigen Event-Katalog auf einer Seite lesen.
CRM-Integrationen
Customermates anbinden: REST-API und MCP in jedem Tarif, signierte Webhooks und eigenes n8n in bezahlten Tarifen und selbst gehostet. Mit klaren Grenzen.
Was ist ein MCP-Server? Tools, lokal vs. remote, Risiken
MCP-Server einfach erklärt: was Claude, ChatGPT oder Cursor darüber bekommen, lokal oder remote, MCP vs. API, Sicherheitsrisiken und ein echtes CRM-Beispiel.
Customermates
Verbinden Sie Ihren eigenen Agenten mit Ihren Kundendatensätzen
Legen Sie in der Testphase einen API-Key an oder fügen Sie den Claude- oder ChatGPT-Connector hinzu und fragen Sie Ihren Agenten nach einem Kundendatensatz und dem nächsten Schritt. Oder lesen Sie die OpenAPI-Spezifikation und schicken Sie eine Suchanfrage.
✓ Keine Kreditkarte benötigt ✓ Erste 14 Tage kostenlos













