geburtsdatum (API & MCP): Seit dem 25.09.2026 lehnte der Filter ein Geburtsdatum mit Uhrzeit ab („Geburts- / Gründungsdatum entspricht nicht dem gültigen Format für Y-m-d."), auch den Wert, den die API selbst in Kunden-Antworten liefert (1995-01-06T00:00:00.000000Z). Integrationen, die diesen Wert unverändert zurückgeben (z.B. Make oder n8n), fanden dadurch keine Kunden mehr. 1995-01-06) und ein Zeitpunkt nach ISO 8601 werden jetzt wieder angenommen. Ein Zeitpunkt trifft den Tag, auf den er in deutscher Zeit (Europe/Berlin) fällt.1995-01-06T00:00:00.000000Z und 1995-01-05T23:00:00.000Z (Mitternacht deutscher Zeit, in UTC angegeben) finden beide Kunden mit Geburtsdatum 06.01.1995.1969 oder 1969-11) werden weiterhin mit einem Validierungsfehler (API: 422) abgelehnt.last_simplr_login_at und maklervollmacht_created_at werden jetzt in deutscher Zeit (Europe/Berlin) gelesen. Ein Jahr (2024), ein Monat (2024-05 oder 2024/05) oder ein Datum (2024-05-01 oder 2024/05/01) trifft das ganze Kalenderjahr, den ganzen Monat bzw. den ganzen Tag. Bisher traf ein Datum nur Mitternacht UTC und damit fast nie eine tatsächliche Anmeldung. "last_simplr_login_at": "2024-05-01" findet alle Anmeldungen am 1. Mai von 00:00 bis 23:59:59 Uhr deutscher Zeit.Z oder Offset (+02:00 oder +0200), auch ohne Sekunden oder mit Millisekunden. Ohne Offset gilt deutsche Zeit.2024-13, 24 oder 01.05.2024), werden jetzt mit einem Validierungsfehler (API: 422) abgelehnt. Bisher führten unvollständige Angaben zu einem Fehler 500 (API) bzw. einer allgemeinen Fehlermeldung (MCP). Ein gültiger Wert vor 1970 oder nach 2038 findet keine Kunden, auch am Rand des Kalenders (z.B. 0000-01-01T00:00:00), wo bisher ebenfalls ein Fehler kam.geburtsdatum (z.B. 1969) wird jetzt ebenfalls mit einem Validierungsfehler (API: 422) abgelehnt. Erwartet wird ein Datum im Format JJJJ-MM-TT. Bisher führte es zu einem Fehler 500._clear: Beim Aktualisieren (PUT kunde/{kunde}) und beim Upsert (PUT kunde/upsert) sowie mit den entsprechenden MCP-Werkzeugen lassen sich Kommunikationseinträge und Details jetzt ausdrücklich leeren. _clear ist eine Liste aus kommunikation.{art} oder details.{feld_id}. "_clear": ["kommunikation.telefon"] löscht die Telefonnummer des Kunden in der Ameise._default), wird er mit einem Validierungsfehler (API: 422) abgelehnt, ebenso ein unbekannter Eintrag._clear ignoriert.null für einen Kommunikationseintrag oder ein Detail lässt den gespeicherten Eintrag jetzt auch über MCP unverändert. Bisher löschte das MCP-Werkzeug zum Aktualisieren von Kunden den Eintrag in der Ameise; die API hat null schon immer übergangen. (MCP)rechtsform_id: direkt oder in _default, auch wenn die Suche einen Kunden findet. Ob sie einen findet, hängt von Daten ab, die sich ändern können; ein Aufruf ohne diese Angaben würde sonst nur so lange funktionieren, wie der Kunde gefunden wird. Bei einem Treffer bleiben die Werte aus _default ungenutzt. Bisher prüfte MCP diese Angaben nicht, und ein unvollständiger Kunde wurde erst von der Ameise abgelehnt.rechtsform_id nicht mehr verlangt, auch bei einer juristischen Person. Sie wird nicht an die Ameise übertragen._search keine Suchbedingung, etwa weil der Wert eines Suchfelds nur in _default steht, wird der Upsert jetzt mit einem Validierungsfehler abgelehnt. Bisher traf eine leere Suche jeden Kunden im Zugriffsbereich, und ein einzelner Treffer wurde überschrieben. Über MCP werden die Suchfelder in _search jetzt wie bei der API geprüft; dort führte bisher schon ein Tippfehler im Suchfeld zu diesem Ergebnis._default gingen verloren._ - : ( ) / ?, höchstens 255 Zeichen, ohne doppelte Tags. Bisher nahm MCP beliebige Tags an.typ dokument) ist betreff jetzt optional. Fehlt er, wird der Dateiname verwendet (auf 100 Zeichen gekürzt). Über MCP wird ein angegebener Betreff jetzt übernommen; bisher wurde er bei Dokumenten durch den Dateinamen ersetzt..jpeg oder mit einer Endung in Großbuchstaben werden akzeptiert. Der MIME-Typ image/jpg entfällt; JPEG-Bilder werden als image/jpeg übergeben. (MCP)nation wird beim Ändern der Bankverbindung eines Vertrags und beim Anlegen oder Ändern einer zusätzlichen Adresse eines Kunden jetzt in Kleinbuchstaben an die Ameise übertragen, die nur diese Schreibweise kennt. DE und de werden gleich behandelt. Bei zusätzlichen Adressen lehnte die Ameise DE über die API bisher ab.geburtsdatum bisher die Uhrzeit der Anfrage (z.B. 1990-05-15T14:28:58.000000Z). Es lautet jetzt auf Mitternacht (1990-05-15T00:00:00.000000Z). Gespeichert und an die Ameise übertragen wurde schon bisher nur das Datum.kunde_nachname, sparte_name und gesellschaft_name waren in jedem Vertrags-Export leer und konnten nicht ausdrücklich angefordert werden. Sie werden jetzt befüllt. Listenwerte mit ungültigen Zeichen erscheinen in Exporten nicht mehr als FALSE (Excel) bzw. leer (CSV, PDF)._clear und _search._search nennen das Feld jetzt verständlich („Tag", „Suchfeld") statt eines internen Schlüssels wie tags.0.
null gelöscht haben, müssen dafür jetzt _clear verwenden.
_default übergeben werden.
. oder & setzen, erhalten dafür jetzt einen Validierungsfehler. Solche Tags lehnte die API schon bisher ab.
kunde/filter mit last_simplr_login_at oder maklervollmacht_created_at nutzen, sollten prüfen, ob sie ein Datum oder einen Zeitpunkt ohne Offset senden: Beide werden jetzt in deutscher Zeit gelesen.type (manual oder oauth), abilities, client und access_token_expires_at (Ablauf des verwendeten stündlichen Access-Tokens einer OAuth-Verbindung).?_token= akzeptiert. Neu erstellte API-Tokens und OAuth-Verbindungen müssen das Token im Authorization-Header übergeben; eine Übergabe per ?_token= wird mit 401 und dem Code QUERY_TOKEN_NOT_ALLOWED abgelehnt.
expires_at jetzt im selben Format wie created_at ausgegeben (z.B. 2026-09-23T12:00:00+00:00 statt 2026-09-23T12:00:00.000000Z). Integrationen, die dieses Feld auswerten, sollten das Format prüfen.
?_token= übergeben, auf den Authorization-Header umzustellen.
GET kunde/{kunde}/archiveintrag und GET vertrag/{vertrag}/dokument, dazu die neuen MCP-Werkzeuge "Kundenarchiv auflisten" und "Vertragsdokumente auflisten".download_url), über die die Datei ohne weitere Anmeldung geladen wird. Die Adresse ist 15 Minuten gültig.ARCHIVE_ENTRY_NOT_FOUND), Eintrag gehört nicht zum angegebenen Kunden (ARCHIVE_ENTRY_NOT_LINKED) oder Eintrag enthält keine Datei (ARCHIVE_ENTRY_NO_CONTENT).Idempotency-Key. Wird derselbe Schlüssel innerhalb von 24 Stunden erneut mit identischem Inhalt gesendet, antwortet die Schnittstelle mit der gespeicherten Antwort des ersten Aufrufs — gekennzeichnet durch den Antwort-Header Idempotency-Replayed: true — statt einen zweiten Datensatz anzulegen. IDEMPOTENCY_KEY_REUSED) abgelehnt.IDEMPOTENT_REQUEST_IN_PROGRESS) mit Retry-After.CONCURRENT_CUSTOMER_WRITE) und sollte wiederholt und nicht als Neuanlage gesendet werden. Das gilt auch für das MCP-Werkzeug "Kunde anlegen oder aktualisieren".
datei, text und uri. Sie enthielten interne Ameise-Adressen, die nicht mehr nach außen gegeben werden — geladen wird ausschließlich über download_url. Zu beachten: Bei Notizen stand der Notiztext bisher im Feld text; er wird jetzt ebenfalls über download_url abgerufen. Der Dateiname bleibt als name erhalten. Außerdem wird download_url jetzt an jedem Eintrag ausgegeben, auch wenn dahinter keine Datei liegt — ob Inhalt vorhanden ist, zeigt erst der Download (404 ARCHIVE_ENTRY_NO_CONTENT). Die Gültigkeit sinkt von 60 auf 15 Minuten, und der Aufbau der Adresse hat sich geändert: früher gespeicherte Adressen funktionieren nicht mehr.
Idempotency-Key senden. Wiederholte Aufrufe zählen weiterhin als Zugriff in der Abrechnung.test: true, Platzhalterwerte) an die hinterlegte URL, statt die letzte echte Aktivität zu wiederholen. Der Test funktioniert damit auch bei einem gerade angelegten Webhook, überträgt in dieser Form keine Kundendaten und kann den Webhook nicht mehr deaktivieren oder eine Störungsmeldung auslösen.

X-Webhook-Test — mit dem Wert sample für den Beispiel-Payload und replay für eine echte Aktivität. Der Beispiel-Payload behält daneben sein test: true im Inhalt; die echte Aktivität enthält bewusst keine solche Markierung, damit sie exakt einer regulären Auslieferung entspricht. Empfänger, die einen Test nicht ein zweites Mal verarbeiten dürfen, sollten daher auf diese Kopfzeile prüfen.vermittler_id übergeben, die die Ameise für den verwendeten Zugang nicht kennt, antwortet die Schnittstelle jetzt mit 422 und nennt das Feld. Bisher wurde der Aufruf an die Ameise geschickt und kam von dort als allgemeiner Fehler 400 ohne Angabe des Feldes zurück. GET kunde/{kunde}/relations und das MCP-Werkzeug "Kunden-Verknüpfungen auflisten" nehmen jetzt page und pageSize (im MCP: page und per_page) entgegen. Bisher wurden currentPage und numberOfPages zwar ausgegeben, es gab aber keine Möglichkeit, die zweite Seite anzufordern — alles jenseits der ersten Seite war nicht erreichbar. brokerId und status. Die bisherigen Felder bleiben unverändert. Anlegen und Löschen einer Verknüpfung sind nicht betroffen.CLAIM_NOT_FOUND) statt 400.ARCHIVE_CUSTOMER_NOT_FOUND bzw. ARCHIVE_CONTRACT_NOT_FOUND); die MCP-Werkzeuge weisen ausdrücklich darauf hin, dass die ID der Ameise unbekannt ist. Bisher kam ein allgemeiner Fehler 500. Andere Störungen werden weiterhin als 500 gemeldet.dueDate, dueDateFrom, dueDateTo), Schadensfälle (claimDate, notificationDate) sowie das Geburtsdatum bei der Vertrags-Bankverbindung werden jetzt vor der Weitergabe in das von der Ameise erwartete Format (ISO 8601 mit Zeitzonen-Angabe) gebracht. Bisher wurde etwa 2026-03-05 von uns angenommen und anschließend von der Ameise abgelehnt. Wer bereits das dokumentierte Format sendet, merkt keinen Unterschied.Idempotency-Key ist jetzt an allen schreibenden Endpunkten ausgewiesen, ebenso die neuen Fehlercodes und der Parameter pageSize.

Betroffen sind ausschließlich Zoho-Felder vom Typ "Verknüpfung". Wird eine Ameise-Kennung wie bisher in ein normales Text- oder Zahlenfeld in Zoho geschrieben — etwa um sie dort über eine eigene Zoho-Automatisierung weiterzuverarbeiten — ändert sich daran nichts.
Bestehende Pipelines übertragen unverändert weiter, solange der Reiter "Felder" nicht erneut gespeichert wird. Ein fest hinterlegter Wert (Konstante) auf einem Verknüpfungsfeld bleibt in jedem Fall unverändert bestehen.

search_tools und execute_tools. Das hält den Kontext von KI-Clients klein und verbessert die Trefferquote bei der Werkzeugauswahl. Die Einstellung steht in der Token-Verwaltung unter "Optionen" und erscheint, sobald eine MCP-Berechtigung ausgewählt ist.

?enabled=1 einen Webhook aktivieren oder ?anrede_id=... bei einer Änderung den Kommunikationskontext neu angelegter Kommunikationen umstellen.
?feld=wert) übergeben wurden, werden nicht mehr ausgewertet und müssen in den Request-Body wandern. Ausgenommen bleiben die dokumentierten Query-Parameter mitteilung-benutzername, mitteilung-passwort-link und mitteilung-erstinfo-unterbinden an den Kunden-Endpunkten sowie die Status- und Löschabfrage unter webhook/managed.



Aufgrund der Umstellung der Verbindung der Zoho API zu einem eigenen System sind für die automatische Migration weitere Rechte erforderlich, wenn Sie Ihre Verbindung nach dem 11.07.2024 aktualisiert haben, dann besteht diese neue Berechtigung bereits.
Die 1. Pipeline-Felder pro Kommunikationsart (E-Mail, Telefon, Mobil, ...) wurden automatisch zu dem neuen Standard-Feld korrigiert