Hinweis: Diese SOAP-API wird zum 30.10.2025 abgeschaltet. Diese API-Version wird seit 2017 nicht mehr aktiv weiterentwickelt. Falls Ihre Anwendung noch SOAP nutzt, kontaktieren Sie bitte den Entwickler für ein Update auf die moderne REST-API.
Die REST-API bietet verbesserte Performance, bessere Dokumentation und neue Features.
Wenn Sie CleverReach mit einem externen System verknüpfen möchten, benötigen Sie in der Regel folgende Informationen:
In diesem Artikel erfahren Sie, wie Sie diese Daten in Ihrem CleverReach-Konto finden:
API-Key (Zugangsschlüssel) ermitteln
-
Loggen Sie sich in Ihren CleverReach Account ein und klicken Sie rechts oben auf das Profil Icon > Mein Account > Schnittstellen > REST API.
-
Klicken Sie auf OAuth2-App anlegen (falls noch keine existiert).
- Geben Sie einen Namen und ggf. eine Weiterleitung-URL (Redirect-URL) an und klicken Sie auf Jetzt erstellen.
-
Ihre OAuth2-App ist angelegt. Klicken Sie auf die drei Punkte ••• rechts > Bearbeiten.
-
Notieren Sie sich unter dem Reiter OAuth2-App Daten die Client ID und das Client Secret, die die App enthält.
-
Erstellen Sie eine Callback-Seite, die nach Abschluss des OAuth-Prozesses aufgerufen wird.
Legen Sie diese Datei auf einem Server ab, auf den sie als redirect_uri verweist.
Leiten Sie den Benutzer zu unserem OAuth-Dienst um (siehe Beispielcode)
Der Benutzer gewährt Ihnen Zugang, indem er sich bei CleverReach® anmeldet.
Nachdem der OAuth-Prozess abgeschlossen ist, wird die redirect_uri aufgerufen.
Die redirect_uri - Ihre Callback-Seite - wird mit einem Code aufgerufen.
Tauschen Sie diesen Code sofort gegen ein Access-Token ein (siehe Beispielcode).
Bitte beachten Sie, dass der Code nur ein paar Sekunden gültig ist!
Auf diese Weise können alle Ihre Nutzer Ihnen ein Token über eine OAuth-App zur Verfügung stellen.
Es ist wirklich einfach. Probieren Sie es aus!
Listen-ID (Gruppen-ID) finden
-
Loggen Sie sich in Ihren CleverReach Account ein und klicken Sie rechts oben auf das Profil Icon > Mein Account > Schnittstellen > REST API.
-
Mein Account
Formular-ID herausfinden
-
Loggen Sie sich in Ihren CleverReach Account ein und klicken Sie rechts oben auf das Profil Icon > Mein Account > Schnittstellen > REST API.
-
Mein Account