Die Contacts Activity API liefert einen zeitlich geordneten Feed aller Änderungen an Ihren Kontakten — Erstellungen, Rollenänderungen, dauerhafte Löschungen und Zusammenführungen. Im Gegensatz zu einer standardmäßigen Kontaktliste erfasst sie Änderungen, die sonst unsichtbar wären, und erleichtert so die Synchronisation externer Tools wie CRMs, Data Warehouses und Marketingplattformen.
Wichtig: Dieser Endpunkt benötigt die Preview API-Version und ein Token mit dem `read_users_companies`-Scope. Fügen Sie in jeder Anfrage den Header `Intercom-Version: Preview` hinzu.
Kontaktereignisse, die von der API verfolgt werden
Der Feed zeichnet die folgenden Kontakt-Lifecycle-Ereignisse auf:
Kontakt erstellt
Kontaktrolle geändert
Kontakt dauerhaft gelöscht
Kontakte zusammengeführt
Dies ist besonders nützlich, wenn Sie Kontaktinformationen mit externen Tools — CRMs, Data Warehouses oder Marketingplattformen — synchronisieren, da Löschungen und Zusammenführungen erfasst werden, die in einer standardmäßigen Kontaktliste nicht angezeigt werden.
So führen Sie Ihre erste API-Anfrage aus
Auf die API wird direkt über HTTP zugegriffen — es gibt keine UI im Produkt. Zum Einstieg:
Authentifizieren Sie sich mit einem Zugriffstoken, das den `read_users_companies`-Scope hat.
Senden Sie eine GET-Anfrage an `/contacts/activities`.
Blättern Sie mit dem Cursor-Parameter `starting_after` durch die Ergebnisse.
Steuern Sie die Seitengröße mit `per_page` (Standard: 50, max.: 150).
Einschränkungen
Beachten Sie die folgenden Beschränkungen beim Erstellen Ihrer Integration:
Zurückgegebene Daten | Der Feed gibt nur IDs, Rollen und Zeitstempel zurück — keine E-Mail-Adressen, Namen oder andere Kontaktattribute. |
Aufbewahrung | Ereignisse werden 90 Tage lang über Time-to-Live (TTL) aufbewahrt. Ereignisse, die älter als 90 Tage sind, sind nicht verfügbar. |
Kein Backfill | Es werden nur Kontakte erfasst, die nach dem 6. August 2026 erstellt oder aktualisiert wurden. Es gibt kein Backfill früherer Kontaktverläufe. |
Mindestens-einmal-Zustellung | Dasselbe Ereignis kann mehr als einmal mit unterschiedlichen Cursorn erscheinen. Entfernen Sie Duplikate anhand der Kontakt-ID und des Ereignistyps in Ihrer Anwendung oder Integration. |
Best-Effort-Schreibvorgänge | Gelegentlich kann ein Ereignis aufgrund eines Schreibfehlers fehlen. Dies beeinflusst niemals die ursprüngliche Kontaktaktion selbst. |
Nur Löschungen | contact.deleted bezieht sich nur auf dauerhafte Löschungen — archivierte Kontakte werden nicht als gelöscht angezeigt. |
Nur Cursor-Paginierung | Verwenden Sie pages.next, um zu prüfen, ob weitere Ereignisse vorliegen, und übergeben Sie es als starting_after, um die nächste Seite abzurufen. Offset-Paginierung wird nicht unterstützt. |
Hinweis: Die Contacts Activity API ist im Contact Activities-Plan in den US-, EU- und AU-Datenregionen verfügbar. Sie ist nicht Teil von Fin Standalone-Workspaces.