Suche

Ermittlung von API-Key, Listen- und Formular-ID

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

  1. Loggen Sie sich in Ihren CleverReach Account ein und klicken Sie rechts oben auf das Profil Icon > Mein Account > Schnittstellen > REST API.


     
  2. Klicken Sie auf OAuth2-App anlegen (falls noch keine existiert).
  3. Geben Sie einen Namen und ggf. eine Weiterleitung-URL (Redirect-URL) an und klicken Sie auf Jetzt erstellen.

  4. Ihre OAuth2-App ist angelegt. Klicken Sie auf die drei Punkte ••• rechts > Bearbeiten. 
  5. Notieren Sie sich unter dem Reiter OAuth2-App Daten die Client ID und das Client Secret, die die App enthält.
  6. 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

  1. Loggen Sie sich in Ihren CleverReach Account ein und klicken Sie im Menü auf Empfänger.
  2. Öffnen Sie die Liste, bei welcher Sie die ID benötigen.

  3. Sie finden die ID oben am Ende der URL:

Formular-ID herausfinden

  1. Loggen Sie sich in Ihren CleverReach Account ein und klicken Sie im Menü auf Formulare.
  2. Klicken Sie rechts neben dem entsprechenden Formular auf die drei Punkte ••• > Einstellungen.

  3. Hier finden Sie die Formular-ID:

Hilfe & Support

Sollten Sie Fragen haben oder Hilfe benötigen, können Sie jederzeit gerne unser Service Team kontaktieren.