{"id":25441,"date":"2025-08-11T10:15:37","date_gmt":"2025-08-11T10:15:37","guid":{"rendered":"https:\/\/clockify.me\/help\/?p=25441"},"modified":"2026-03-03T06:49:30","modified_gmt":"2026-03-03T06:49:30","slug":"api-webhook-settings","status":"publish","type":"post","link":"https:\/\/clockify.me\/help\/de\/administration\/api-webhook-settings","title":{"rendered":"API- und Webhook-Einstellungen"},"content":{"rendered":"
Wer kann diese Funktion nutzen?<\/span>
<\/rect><\/mask><\/path><\/g><\/svg>Alle Benutzer (API); Besitzer von Arbeitsbereichen und Administratoren (Webhook-Einstellungen)<\/span><\/div>
<\/rect><\/mask><\/path><\/g><\/svg>Kostenlose und kostenpflichtige Abonnements<\/span><\/div><\/div><\/div>\n\n\n\n

Clockify erm\u00f6glicht es dir, erweiterte Einstellungen f\u00fcr dein Profil zu verwalten und zu konfigurieren, wie zum Beispiel Webhooks<\/strong> und API-Schl\u00fcssel<\/strong>. So erh\u00e4ltst du mehr Kontrolle \u00fcber die Sicherheit und Effizienz deines Kontos.<\/p>\n\n\n\n

API-Schl\u00fcssel<\/h2>\n\n\n\n

Es ist wichtig, deinen API-Schl\u00fcssel an einem sicheren Ort zu speichern. Wenn du einen Schl\u00fcssel verlierst oder ihn nicht speicherst, wird die Generierung eines neuen Schl\u00fcssels den alten Schl\u00fcssel deaktivieren, wodurch m\u00f6glicherweise bestehende Einstellungen und Integrationen unterbrochen werden.
In Clockify kannst du deine API-Schl\u00fcssel speichern und diese nach Bedarf bearbeiten.<\/p>\n\n\n\n

Du findest API-Schl\u00fcssel-Einstellungen in der Registerkarte Erweitert<\/strong> in deinen Profileinstellungen<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Klicke auf die Schaltfl\u00e4che API-Schl\u00fcssel verwalten<\/strong> und eine Liste mit allen APIs wird angezeigt, die du auf der ge\u00f6ffneten Seite generiert hast. <\/p>\n\n\n\n

Hier kannst du deine API-Schl\u00fcssel auf verschiedene Arten verwalten. <\/p>\n\n\n\n

API-Schl\u00fcssel generieren<\/strong><\/h3>\n\n\n\n

So erstellst du einen neuen Schl\u00fcssel:<\/p>\n\n\n\n

    \n
  1. Klicke auf Neue generieren<\/strong> in der oberen rechten Ecke der Seite<\/li>\n\n\n\n
  2. Fenster API-Schl\u00fcssel generieren<\/strong> wird ge\u00f6ffnet <\/li>\n\n\n\n
  3. Gib den Name f\u00fcr deinen neuen API-Schl\u00fcssel ein
    Gib einen aussagekr\u00e4ftigen Namen ein, damit du wei\u00dft, wof\u00fcr es ist. <\/strong><\/li>\n\n\n\n
  4. Klicke auf Generieren<\/strong><\/li>\n<\/ol>\n\n\n\n

    Dein neuer Schl\u00fcssel wird automatisch erstellt und zur Liste auf der Seite API-Schl\u00fcssel verwalten<\/strong> hinzugef\u00fcgt.<\/p>\n\n\n\n

    API-Schl\u00fcssel bearbeiten<\/strong><\/h3>\n\n\n\n

    So kannst du \u00c4nderungen an einem API-Schl\u00fcssel vornehmen:<\/p>\n\n\n\n

      \n
    1. Klicke auf das Dreipunkt-Men\u00fc<\/strong> neben dem API-Schl\u00fcssel, den du deaktivieren m\u00f6chtest<\/li>\n\n\n\n
    2. W\u00e4hle die Option Umbenennen\/L\u00f6schen <\/strong>
      \"\"<\/li>\n\n\n\n
    3. Gib einen neuen Namen oder klicke auf L\u00f6schen<\/strong>, um die Aktion zu best\u00e4tigen<\/li>\n<\/ol>\n\n\n\n

      Der neue API-Schl\u00fcssel-Name wird automatisch auf der Seite API-Schl\u00fcssel verwalten<\/strong> aktualisiert.
      Nach dem L\u00f6schen kann dieser API-Schl\u00fcssel nicht mehr verwendet werden und wird automatisch von der Seite API-Schl\u00fcssel verwalten<\/strong> und aus der Registerkarte Konten<\/strong> in den Arbeitsbereicheinstellungen<\/strong> entfernt.<\/p>\n\n\n\n

      Webhooks<\/h2>\n\n\n\n
      <\/rect><\/mask><\/path><\/g><\/svg>Hinweis<\/span><\/div>
      \n

      Die Funktion ist f\u00fcr Arbeitsbereich-Besitzer und Administratoren verf\u00fcgbar. Der Webhooks-Abschnitt ist nicht f\u00fcr andere Benutzerrollen verf\u00fcgbar.<\/p>\n<\/div><\/div>\n\n\n\n

      Mit der Erstellung von Webhooks erh\u00e4ltst du Echtzeit-Benachrichtigungen und Datenaktualisierungen.<\/p>\n\n\n\n

      Befolge diese Schritte:<\/p>\n\n\n\n

        \n
      1. Gehe zu Einstellungen<\/strong><\/li>\n\n\n\n
      2. W\u00e4hle die Registerkarte Erweitert<\/strong> aus<\/li>\n\n\n\n
      3. Klicke im Abschnitt Webhooks<\/strong> auf Webhooks verwalten<\/strong><\/li>\n\n\n\n
      4. Du wirst zur Seite Webhooks<\/strong> umgeleitet<\/li>\n<\/ol>\n\n\n\n

        Falls du ein Mitglied in mehreren Arbeitsbereichen bist, w\u00e4hle den gew\u00fcnschten Arbeitsbereich.<\/p>\n\n\n\n

        \"\"<\/figure>\n\n\n\n

        Um einen neuen Webhook zu erstellen, solltest du:<\/p>\n\n\n\n

          \n
        1. Auf die Schaltfl\u00e4che Neu erstellen<\/strong> in der rechten Ecke oben klicken<\/li>\n\n\n\n
        2. Im Fenster Webhook erstellen<\/strong> die folgenden Details eingeben:
          \"\"
          Name<\/strong>: Webhook-Name bestimmen
          Endpunkt<\/strong>: Webhook-Endpunkt-URL eingeben
          Ereignis<\/strong>: Das Ergebnis w\u00e4hlen, das deinen Webhook triggert<\/li>\n\n\n\n
        3. Klicke auf Erstellen<\/strong>, um den Vorgang abzuschlie\u00dfen<\/li>\n<\/ol>\n\n\n\n

          Falls du ein Mitglied in mehreren Arbeitsbereichen bist, w\u00e4hle den gew\u00fcnschten Arbeitsbereich.<\/p>\n\n\n\n

          Die erstellten Webhook-Ereignisse werden alphabetisch sortiert. <\/p>\n\n\n\n

          <\/rect><\/mask><\/path><\/g><\/svg>Hinweis<\/span><\/div>
          \n

          Ein Webhook-Ereignis kann w\u00e4hrend der Erstellung deaktiviert werden, falls der Clockify-Arbeitsbereich keinen Abonnementplan hat, der diese Funktion unterst\u00fctzt.  <\/p>\n<\/div><\/div>\n\n\n\n

          Webhook-Details<\/h3>\n\n\n\n

          Wenn du die Details eines Webhooks sehen m\u00f6chtest, kannst du das \u00fcber das Dreipunkt-Men\u00fc dieses Webhooks tun. <\/p>\n\n\n\n

            \n
          • Gehe zu dem Webhook, den du pr\u00fcfen m\u00f6chtest<\/li>\n\n\n\n
          • \u00d6ffne Details<\/strong> im Dreipunkt-Men\u00fc <\/li>\n\n\n\n
          •  Neue Seite wird mit der Liste der Webhook-Versuche<\/strong> ge\u00f6ffnet <\/li>\n<\/ul>\n\n\n\n

            Hier siehst du die Versuchszeit und den Status des Ereignisses. <\/p>\n\n\n\n

            <\/rect><\/mask><\/path><\/g><\/svg>Hinweis<\/span><\/div>
            \n

            Die Versuchszeit folgt dem in den Einstellungen festgelegten Format.<\/p>\n<\/div><\/div>\n\n\n\n

            Ein Test-Webhook kann ebenfalls in den Webhook-Versuchen mit dem entsprechenden Status und der Payload angezeigt werden. <\/p>\n\n\n\n

            Webhook-Wiederholungsmechanismus (Retry)<\/h3>\n\n\n\n

            Clockify nutzt einen automatisierten Wiederholungsmechanismus, um vor\u00fcbergehende Ausf\u00e4lle oder Probleme mit dem Endpunkt abzufangen. <\/p>\n\n\n\n

            Falls deine Domain nicht erreichbar ist, versucht das System automatisch bis zu 4 Mal \u00fcber einen Zeitraum von 72 Stunden, den Webhook erneut zu senden: <\/p>\n\n\n\n

              \n
            • Wiederholung 1: 12 Sekunden nach dem ersten Fehler<\/li>\n\n\n\n
            • Wiederholung 2: 10 Minuten sp\u00e4ter<\/li>\n\n\n\n
            • Wiederholung 3: 30 Minuten sp\u00e4ter<\/li>\n\n\n\n
            • Wiederholung 4: 72 Stunden sp\u00e4ter (bei l\u00e4ngerfristigen Ausf\u00e4llen)<\/li>\n<\/ul>\n\n\n\n
              <\/rect><\/mask><\/path><\/g><\/svg>Info<\/span><\/div>
              \n

              Nur HTTP-Antworten der Kategorie 2xx werden als \u201eErfolgreich\u201c markiert. Zeit\u00fcberschreitungen oder Antworten au\u00dferhalb des 2xx-Bereichs werden als \u201eFehlgeschlagen\u201c oder \u201eWird wiederholt\u201c gekennzeichnet.<\/p>\n<\/div><\/div>\n\n\n\n

              Du kannst bei jedem Webhook-Zustellversuch auf Erneut senden klicken, unabh\u00e4ngig von seinem aktuellen Status. Wenn der manuelle Sendeversuch erfolgreich ist, wird der Status auf \u201eErfolgreich\u201c aktualisiert.<\/p>\n\n\n\n

              In deinem Tab Einstellungen<\/strong> hilft dir eine Farbcodierung dabei, den Status auf einen Blick zu erfassen: <\/p>\n\n\n\n

                \n
              • Webhook-Status<\/strong>: Aktiv, Deaktiviert<\/li>\n\n\n\n
              • Zustellversuch-Status<\/strong>: Erfolgreich, Wird wiederholt, Fehlgeschlagen <\/li>\n<\/ul>\n\n\n\n
                \"\"<\/figure>\n\n\n\n

                Webhooks bearbeiten<\/h3>\n\n\n\n

                Wenn du Daten zu den Webhooks \u00e4ndern m\u00f6chtest, kannst du dies \u00fcber die Bearbeitungsoption tun.<\/p>\n\n\n\n

                  \n
                • Gehe zu dem Webhook, den du bearbeiten m\u00f6chtest<\/li>\n\n\n\n
                • \u00d6ffne Bearbeiten<\/strong> im Dreipunkt-Men\u00fc <\/li>\n\n\n\n
                •  Neue Seite wird mit der Liste der Webhook-Versuche<\/strong> ge\u00f6ffnet <\/li>\n<\/ul>\n\n\n\n

                  Hier kannst du alle Elemente des erstellten Webhooks \u00e4ndern: <\/p>\n\n\n\n

                    \n
                  • Webhook-Namen \u00e4ndern<\/li>\n\n\n\n
                  • Endpoint-URL \u00e4ndern<\/li>\n\n\n\n
                  • Ein anderes Ereignis aus dem Dropdown ausw\u00e4hlen<\/li>\n\n\n\n
                  • Signatur-Geheimnis<\/strong> \u00e4ndern (zur\u00fccksetzen) <\/li>\n<\/ul>\n\n\n\n

                    Webhooks l\u00f6schen<\/h3>\n\n\n\n

                    Wenn du einen Webhook l\u00f6schen m\u00f6chtest, der veraltet ist oder den du nicht mehr benutzt, kannst du das auf folgende Weise tun: <\/p>\n\n\n\n

                      \n
                    • Gehe zu dem Webhook, den du bearbeiten m\u00f6chtest<\/li>\n\n\n\n
                    • W\u00e4hle L\u00f6schen<\/strong> im Dreipunkt-Men\u00fc <\/li>\n\n\n\n
                    • Klicke auf L\u00f6schen<\/strong> im Best\u00e4tigungsfenster<\/li>\n<\/ul>\n\n\n\n

                      Marketplace-Webhooks<\/h3>\n\n\n\n

                      Im Clockify Marketplace verf\u00fcgen Add-on-Nutzer bei Webhook-Zustellversuchen nicht \u00fcber eine Schaltfl\u00e4che zum erneuten Senden<\/strong>.<\/p>","protected":false},"excerpt":{"rendered":"Clockify allows you to manage and configure advanced settings for your profile s…","protected":false},"author":25,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_helpful_status":1,"_searchwp_excluded":"","footnotes":""},"categories":[29],"tags":[],"class_list":["post-25441","post","type-post","status-publish","format-standard","hentry","category-my-account"],"acf":[],"featured_image_src":null,"author_info":{"display_name":"tamara radijevac","author_link":"https:\/\/clockify.me\/help\/de\/author\/tamara-radijevac"},"_links":{"self":[{"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/posts\/25441","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/users\/25"}],"replies":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/comments?post=25441"}],"version-history":[{"count":16,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/posts\/25441\/revisions"}],"predecessor-version":[{"id":30025,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/posts\/25441\/revisions\/30025"}],"wp:attachment":[{"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/media?parent=25441"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/categories?post=25441"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/tags?post=25441"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}