{"id":4770,"date":"2024-11-14T12:53:57","date_gmt":"2024-11-14T11:53:57","guid":{"rendered":"https:\/\/help.edudip.com\/?post_type=ht_kb&#038;p=4770"},"modified":"2024-11-14T13:19:43","modified_gmt":"2024-11-14T12:19:43","slug":"webhooks","status":"publish","type":"ht_kb","link":"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/","title":{"rendered":"Webhooks"},"content":{"rendered":"\n<p>Webhooks are automatic notifications via HTTP that are triggered when an event occurs in an application. They enable immediate data transfer to other systems without the need for constant queries and are well suited for integrations and workflow automation.<\/p>\n\n\n\n<p>As an administrator, go to the settings of your account. Under the menu item \u201cWebhooks\u201d you will find a list of existing webhooks and the option to add new ones.<br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"create-new-webhooks\" >Create new webhooks:<\/h2>\n\n\n\n<p>To create a new webhook, please click on the menu item \u201cCreate webhook\u201d. You can then give the webhook a name of your choice. This is only for your orientation and has no further influence on the actual webhook.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"455\" src=\"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1024x455.png\" alt=\"\" class=\"wp-image-4771\" srcset=\"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1024x455.png 1024w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-300x133.png 300w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-768x341.png 768w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-50x22.png 50w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-920x408.png 920w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-600x266.png 600w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-320x142.png 320w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image.png 1043w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Next, please specify the category for which you want to receive the corresponding events.<\/p>\n\n\n\n<p>Example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>Single category: <\/em>webinar.created \u2192 A webinar was created<\/li>\n\n\n\n<li><em>Multiple categories: <\/em>webinar.created, webinar.deleted \u2192 Webinar created &amp; deleted<\/li>\n\n\n\n<li>Wildcard categories: webinar.* \u2192 contains for example webinar.created, webinar.updated, webinar.deleted<\/li>\n<\/ul>\n\n\n\n<p>In order for the webhook to be finally set up, you must add the address of the HTTP endpoint and save the settings.<\/p>\n\n\n\n<p>Webhooks are sent JSON serialized. Further information on <strong>JavaS<\/strong>cript <strong>O<\/strong>bject <strong>N<\/strong>otation can be found <a href=\"https:\/\/de.wikipedia.org\/wiki\/JavaScript_Object_Notation\">here in the Wikipedia article<\/a>.<\/p>\n\n\n\n<p>In the webhook overview, you can see directly whether there have been errors in the delivery of individual webhooks.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Failed webhooks are retried for up to 24 hours. Redeliveries are delayed exponentially\n<ul class=\"wp-block-list\">\n<li>First delivery: Immediately<\/li>\n\n\n\n<li>Second: After two seconds<\/li>\n\n\n\n<li>Third: After four seconds<\/li>\n\n\n\n<li>Fourth: After eight seconds<\/li>\n\n\n\n<li>Fifth: After 16 seconds<\/li>\n\n\n\n<li>etc.<\/li>\n\n\n\n<li>17th delivery: After 24 hours<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p>Further details on the failed deliveries can be found if you select the corresponding webhook. There you also have the option of retriggering the delivery manually.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"847\" height=\"1024\" src=\"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1-847x1024.png\" alt=\"\" class=\"wp-image-4773\" srcset=\"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1-847x1024.png 847w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1-248x300.png 248w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1-768x929.png 768w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1-41x50.png 41w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1-920x1113.png 920w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1-600x726.png 600w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1-320x387.png 320w, https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1.png 1016w\" sizes=\"auto, (max-width: 847px) 100vw, 847px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"urgent-security-notice\" >Urgent security notice:<\/h2>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong><em><strong>Webhooks can be sent by anyone.<\/strong><\/em><\/strong><strong><em><strong>To ensure that edudip is the sender, the signature must be verified.<\/strong><\/em><\/strong><strong><em><strong>We use <\/strong><\/em><\/strong><a href=\"https:\/\/en.wikipedia.org\/wiki\/HMAC\"><strong><em><strong>HMAC<\/strong><\/em><\/strong><\/a><strong><em><strong> to sign the data in the payloads.<\/strong><\/em><\/strong><\/p>\n<\/blockquote>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Each webhook request contains the following relevant HTTP headers:\n<ul class=\"wp-block-list\">\n<li><em>X-Edudip-Signature-Algorithm<\/em>: The algorithm used for the signature (e.g. SHA256).<\/li>\n\n\n\n<li><em>X-Edudip-Signature<\/em>: The actual signature of the payload that is required for verification.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>To verify the signature:\n<ul class=\"wp-block-list\">\n<li>Load the public key that belongs to our private key. We provide this public key.<\/li>\n\n\n\n<li>Hash the payload of the webhook with the algorithm from <code>theX-Edudip-Signature-Algorithm<\/code> header to obtain the payload hash.<\/li>\n\n\n\n<li>Use the public key to compare the received signature (X-Edudip-Signature) with the hashed payload.<\/li>\n\n\n\n<li><a href=\"https:\/\/cdn.edudip.com\/public\/assets\/webhook-key.pub\">Click here to download the public key<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n","protected":false},"author":15,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"footnotes":""},"ht_kb_category":[82],"ht_kb_tag":[],"class_list":["post-4770","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-good-to-know"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.5 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Webhooks - edudip Hilfecenter<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Webhooks - edudip Hilfecenter\" \/>\n<meta property=\"og:description\" content=\"Webhooks are automatic notifications via HTTP that are triggered when an event occurs in an application. They enable immediate data transfer to other systems without the need for constant queries and are well suited for integrations and workflow automation. As an administrator, go to the settings of your account. Under [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/\" \/>\n<meta property=\"og:site_name\" content=\"edudip Hilfecenter\" \/>\n<meta property=\"article:modified_time\" content=\"2024-11-14T12:19:43+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1024x455.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/\",\"url\":\"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/\",\"name\":\"Webhooks - edudip Hilfecenter\",\"isPartOf\":{\"@id\":\"https:\/\/help.edudip.com\/de\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1024x455.png\",\"datePublished\":\"2024-11-14T11:53:57+00:00\",\"dateModified\":\"2024-11-14T12:19:43+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/#primaryimage\",\"url\":\"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1024x455.png\",\"contentUrl\":\"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1024x455.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/help.edudip.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Article\",\"item\":\"https:\/\/help.edudip.com\/en\/knowledge-base\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Webhooks\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/help.edudip.com\/de\/#website\",\"url\":\"https:\/\/help.edudip.com\/de\/\",\"name\":\"edudip Hilfecenter\",\"description\":\"Support\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/help.edudip.com\/de\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Webhooks - edudip Hilfecenter","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/","og_locale":"en_US","og_type":"article","og_title":"Webhooks - edudip Hilfecenter","og_description":"Webhooks are automatic notifications via HTTP that are triggered when an event occurs in an application. They enable immediate data transfer to other systems without the need for constant queries and are well suited for integrations and workflow automation. As an administrator, go to the settings of your account. Under [&hellip;]","og_url":"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/","og_site_name":"edudip Hilfecenter","article_modified_time":"2024-11-14T12:19:43+00:00","og_image":[{"url":"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1024x455.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/","url":"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/","name":"Webhooks - edudip Hilfecenter","isPartOf":{"@id":"https:\/\/help.edudip.com\/de\/#website"},"primaryImageOfPage":{"@id":"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/#primaryimage"},"image":{"@id":"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/#primaryimage"},"thumbnailUrl":"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1024x455.png","datePublished":"2024-11-14T11:53:57+00:00","dateModified":"2024-11-14T12:19:43+00:00","breadcrumb":{"@id":"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/#primaryimage","url":"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1024x455.png","contentUrl":"https:\/\/help.edudip.com\/wp-content\/uploads\/2024\/11\/image-1024x455.png"},{"@type":"BreadcrumbList","@id":"https:\/\/help.edudip.com\/en\/knowledge-base\/webhooks\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/help.edudip.com\/en\/"},{"@type":"ListItem","position":2,"name":"Article","item":"https:\/\/help.edudip.com\/en\/knowledge-base\/"},{"@type":"ListItem","position":3,"name":"Webhooks"}]},{"@type":"WebSite","@id":"https:\/\/help.edudip.com\/de\/#website","url":"https:\/\/help.edudip.com\/de\/","name":"edudip Hilfecenter","description":"Support","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/help.edudip.com\/de\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/help.edudip.com\/en\/wp-json\/wp\/v2\/ht_kb\/4770","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.edudip.com\/en\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/help.edudip.com\/en\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/help.edudip.com\/en\/wp-json\/wp\/v2\/users\/15"}],"replies":[{"embeddable":true,"href":"https:\/\/help.edudip.com\/en\/wp-json\/wp\/v2\/comments?post=4770"}],"version-history":[{"count":2,"href":"https:\/\/help.edudip.com\/en\/wp-json\/wp\/v2\/ht_kb\/4770\/revisions"}],"predecessor-version":[{"id":4778,"href":"https:\/\/help.edudip.com\/en\/wp-json\/wp\/v2\/ht_kb\/4770\/revisions\/4778"}],"wp:attachment":[{"href":"https:\/\/help.edudip.com\/en\/wp-json\/wp\/v2\/media?parent=4770"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.edudip.com\/en\/wp-json\/wp\/v2\/ht_kb_category?post=4770"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.edudip.com\/en\/wp-json\/wp\/v2\/ht_kb_tag?post=4770"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}