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.

  1. Agenten

    Jeder Tarif, Mate in bezahlter Cloud

    Mate ist eingebaut. Oder verbinden Sie die KI, für die Sie schon bezahlen, und sie arbeitet mit denselben Daten und Regeln.

  2. Posteingang

    Cloud, ab Pro

    E-Mail und LinkedIn, dazu WhatsApp, Instagram und Telegram, direkt beim Kunden, zu dem das Gespräch gehört.

  3. Daten

    Jeder Tarif

    Kunden, Deals und jede Liste, die Ihr Geschäft braucht, mit eigenen Feldern, Phasen und Ansichten.

  4. Wissen

    Jeder Tarif

    Leitfä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.

  1. Beschreiben Sie Ihr Geschäft

    Ein Satz zu Ihrem Team, Ihren Kunden und wie Sie verkaufen.

  2. Mate baut den Workspace

    Die KI stellt ein paar Fragen und legt Listen, Pipeline, Dashboard und Leitfaden an.

  3. Arbeiten Sie darin

    Verbinden Sie LinkedIn und E-Mail. Unten können Sie ein fertiges Beispiel ausprobieren.

Ihre Beschreibung für Mate

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

Customermates für Berater

So funktioniert es

CRM API in 5 Schritten.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

CRM API in Customermates, mit BeispieldatenCRM API in Customermates, mit Beispieldaten

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.

ZielMethode und Pfad
Listen und ihre typeId findenPOST /api/v1/model/discover
Felder, Beziehungen, Options-IDs und Schema-Revision lesenPOST /api/v1/model/read
Eine Liste filtern, sortieren und blätternPOST /api/v1/records/query
Listenübergreifend nach Text suchenPOST /api/v1/records/search
Einen Datensatz lesenPOST /api/v1/records/read
Anlegen, ändern, löschen, verknüpfen oder Verknüpfung lösenPOST /api/v1/records/mutate
Bis zu 100 Datensätze ändern oder löschenPOST /api/v1/records/mutate mit updateMany oder deleteMany
Eine Liste exportieren oder bis zu 100 Datensätze importierenPOST /api/v1/records/export oder POST /api/v1/records/import
Eine Datei in ein Feld vom Typ Datei hochladenPOST /api/v1/files/uploads, dann POST /api/v1/records/mutate
Ein Feld summieren oder zählen, etwa den Pipeline-WertPOST /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/read liefert die fieldId jedes 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/query nimmt typeId, filters, sort, page und pageSize (bis 500). Filter folgen der Filtersyntax, die auch App und MCP verwenden.
  • Schreibvorgänge sind abgesichert. Eine Mutation enthält expectedRevision (die Schema-Revision), einen idempotencyKey und die eigentliche mutation; Änderungen und Löschungen enthalten zusätzlich die expectedVersion des Datensatzes. Wer dieselbe Anfrage mit demselben Key erneut sendet, führt sie nicht doppelt aus.
  • Verknüpfungen sind eine eigene Aktion. link und unlink nehmen eine relationId, eine source und ein target als Datensatzreferenz. Eine Änderung entfernt nie Verknüpfungen, die Sie nicht genannt haben.
  • Bulk-Schreibvorgänge nehmen bis zu 100 Datensätze. updateMany wendet eine Änderung atomar auf bis zu 100 Datensätze an, deleteMany verschiebt 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.deleted beim Verschieben in den Papierkorb, record.restored und record.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 Wert before und after. 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

  1. Key anlegen

    Öffnen Sie Einstellungen → API-Schlüssel & Konnektoren, 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. Ablauf und Rotation erklärt die Anleitung zu API-Keys.
  2. Schema laden

    Rufen Sie /api/v1/openapi unter Ihrer Workspace-Adresse ab und importieren Sie das Dokument in Postman, Insomnia oder einen Client-Generator. Senden Sie danach POST /api/v1/model/discover mit {"search":"deal"}, um die typeId Ihrer Deals zu erhalten, und POST /api/v1/model/read mit {"typeIds":["<deal-type-id>"]}, um Felder, Phasen-Optionen und Schema-revision zu sehen.
  3. Abfragen

    Senden Sie POST /api/v1/records/query mit dem Header x-api-key und 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.
  4. Schreiben

    Setzen Sie einen Deal mit POST /api/v1/records/mutate in 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.
  5. 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 POST an /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 in auf einem Feld.
  • Keine veröffentlichte Anfragequote. Ein ausgelasteter Workspace antwortet mit 429 und einem Retry-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.

CRMAPI im kostenlosen oder EinstiegstarifWie die Nutzung begrenzt wird
HubSpotJaPrivate Apps in Free und Starter: 100 Anfragen pro 10 Sekunden und 250.000 täglich pro Konto, mehr in Professional und Enterprise
PipedriveJeder Tarif enthält ein API-TokenTägliches Token-Budget: 30.000 Basis-Tokens mal Tarif-Multiplikator mal Nutzerlizenzen
Zoho CRMJa, auch in der Free EditionCredits pro 24 Stunden: 5.000 in Free, in bezahlten Editionen mehr pro Nutzer
EspoCRMJa, auch in der kostenlosen selbst gehosteten VersionAPI-Key, HMAC oder Basic Auth über eigene API-Nutzer, deren Rollen die Rechte festlegen
CustomermatesJeder Tarif und Self-HostingKeine 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.

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