[{"data":1,"prerenderedAt":429},["ShallowReactive",2],{"search-de":3,"content-de-api\u002Fevents":4,"surround-de-\u002Fapi\u002Fevents":420},[],{"id":5,"title":6,"body":7,"description":13,"extension":413,"meta":414,"navigation":415,"path":416,"seo":417,"stem":418,"__hash__":419},"content_de\u002F2.api\u002F7.events.md","Events-API",{"type":8,"value":9,"toc":406},"minimark",[10,14,19,52,56,63,79,97,101,201,204,235,241,259,263,270,351,355,361,402],[11,12,13],"p",{},"Kontaktereignisse senden, um Segmentierung und Automations-Trigger zu steuern.",[15,16,18],"h2",{"id":17},"endpunkt","Endpunkt",[20,21,22,35],"table",{},[23,24,25],"thead",{},[26,27,28,32],"tr",{},[29,30,31],"th",{},"Methode",[29,33,34],{},"Pfad",[36,37,38],"tbody",{},[26,39,40,47],{},[41,42,43],"td",{},[44,45,46],"code",{},"POST",[41,48,49],{},[44,50,51],{},"\u002Fapi\u002Fv1\u002Fevents",[15,53,55],{"id":54},"authentifizierung","Authentifizierung",[11,57,58,59,62],{},"Dieser Endpunkt erfordert einen API-Key mit dem Scope ",[44,60,61],{},"events:write",", übergeben als Bearer-Token:",[64,65,70],"pre",{"className":66,"code":67,"language":68,"meta":69,"style":69},"language-http shiki shiki-themes github-light github-dark-dimmed","Authorization: Bearer \u003Ckey>\n","http","",[44,71,72],{"__ignoreMap":69},[73,74,77],"span",{"class":75,"line":76},"line",1,[73,78,67],{},[11,80,81,82,85,86,88,89,92,93,96],{},"Anfragen ohne gültigen Key liefern ",[44,83,84],{},"401","; Anfragen mit einem Key ohne den Scope ",[44,87,61],{}," liefern ",[44,90,91],{},"403",". Der Endpunkt ist auf 10 Anfragen pro Sekunde begrenzt; darüber hinaus liefert er ",[44,94,95],{},"429",".",[15,98,100],{"id":99},"request-body","Request-Body",[64,102,106],{"className":103,"code":104,"language":105,"meta":69,"style":69},"language-json shiki shiki-themes github-light github-dark-dimmed","{\n  \"email\": \"john@example.com\",\n  \"eventName\": \"purchase_completed\",\n  \"eventProperties\": {\n    \"orderId\": \"ORD-123\",\n    \"amount\": 99.99\n  },\n  \"createContactIfNotExists\": true\n}\n","json",[44,107,108,114,131,144,153,166,178,184,195],{"__ignoreMap":69},[73,109,110],{"class":75,"line":76},[73,111,113],{"class":112},"sYgZi","{\n",[73,115,117,121,124,128],{"class":75,"line":116},2,[73,118,120],{"class":119},"snmFh","  \"email\"",[73,122,123],{"class":112},": ",[73,125,127],{"class":126},"s-HuK","\"john@example.com\"",[73,129,130],{"class":112},",\n",[73,132,134,137,139,142],{"class":75,"line":133},3,[73,135,136],{"class":119},"  \"eventName\"",[73,138,123],{"class":112},[73,140,141],{"class":126},"\"purchase_completed\"",[73,143,130],{"class":112},[73,145,147,150],{"class":75,"line":146},4,[73,148,149],{"class":119},"  \"eventProperties\"",[73,151,152],{"class":112},": {\n",[73,154,156,159,161,164],{"class":75,"line":155},5,[73,157,158],{"class":119},"    \"orderId\"",[73,160,123],{"class":112},[73,162,163],{"class":126},"\"ORD-123\"",[73,165,130],{"class":112},[73,167,169,172,174],{"class":75,"line":168},6,[73,170,171],{"class":119},"    \"amount\"",[73,173,123],{"class":112},[73,175,177],{"class":176},"sviXB","99.99\n",[73,179,181],{"class":75,"line":180},7,[73,182,183],{"class":112},"  },\n",[73,185,187,190,192],{"class":75,"line":186},8,[73,188,189],{"class":119},"  \"createContactIfNotExists\"",[73,191,123],{"class":112},[73,193,194],{"class":176},"true\n",[73,196,198],{"class":75,"line":197},9,[73,199,200],{"class":112},"}\n",[11,202,203],{},"Felder:",[205,206,207,214,219,225],"ul",{},[208,209,210,213],"li",{},[44,211,212],{},"email"," (erforderlich)",[208,215,216,213],{},[44,217,218],{},"eventName",[208,220,221,224],{},[44,222,223],{},"eventProperties"," (optionales Objekt)",[208,226,227,230,231,234],{},[44,228,229],{},"createContactIfNotExists"," (optionaler Boolean, Standard ",[44,232,233],{},"false",")",[11,236,237,238,240],{},"Einschränkungen für ",[44,239,218],{},":",[205,242,243,246,256],{},[208,244,245],{},"muss mit einem Buchstaben beginnen",[208,247,248,249,252,253],{},"erlaubte Zeichen: Buchstaben, Ziffern, ",[44,250,251],{},"_",", ",[44,254,255],{},"-",[208,257,258],{},"maximale Länge: 100",[15,260,262],{"id":261},"erfolgsantwort","Erfolgsantwort",[11,264,265,266,269],{},"Liefert ",[44,267,268],{},"201"," mit dem Ergebnis des Ereignisses:",[64,271,273],{"className":103,"code":272,"language":105,"meta":69,"style":69},"{\n  \"data\": {\n    \"eventId\": \"evt_m6e...\",\n    \"contactId\": \"j57...\",\n    \"eventName\": \"purchase_completed\",\n    \"triggeredAutomations\": 1,\n    \"contactCreated\": true\n  }\n}\n",[44,274,275,279,286,298,310,321,333,342,347],{"__ignoreMap":69},[73,276,277],{"class":75,"line":76},[73,278,113],{"class":112},[73,280,281,284],{"class":75,"line":116},[73,282,283],{"class":119},"  \"data\"",[73,285,152],{"class":112},[73,287,288,291,293,296],{"class":75,"line":133},[73,289,290],{"class":119},"    \"eventId\"",[73,292,123],{"class":112},[73,294,295],{"class":126},"\"evt_m6e...\"",[73,297,130],{"class":112},[73,299,300,303,305,308],{"class":75,"line":146},[73,301,302],{"class":119},"    \"contactId\"",[73,304,123],{"class":112},[73,306,307],{"class":126},"\"j57...\"",[73,309,130],{"class":112},[73,311,312,315,317,319],{"class":75,"line":155},[73,313,314],{"class":119},"    \"eventName\"",[73,316,123],{"class":112},[73,318,141],{"class":126},[73,320,130],{"class":112},[73,322,323,326,328,331],{"class":75,"line":168},[73,324,325],{"class":119},"    \"triggeredAutomations\"",[73,327,123],{"class":112},[73,329,330],{"class":176},"1",[73,332,130],{"class":112},[73,334,335,338,340],{"class":75,"line":180},[73,336,337],{"class":119},"    \"contactCreated\"",[73,339,123],{"class":112},[73,341,194],{"class":176},[73,343,344],{"class":75,"line":186},[73,345,346],{"class":112},"  }\n",[73,348,349],{"class":75,"line":197},[73,350,200],{"class":112},[15,352,354],{"id":353},"häufige-fehler","Häufige Fehler",[11,356,357,358,240],{},"Fehler verwenden den Standard-Envelope ",[44,359,360],{},"{ \"error\": { \"category\", \"message\", \"data\"? } }",[205,362,363,376,385,390,397],{},[208,364,365,368,369,372,373,375],{},[44,366,367],{},"404"," ",[44,370,371],{},"not_found"," — der Kontakt existiert nicht und ",[44,374,229],{}," ist nicht aktiviert",[208,377,378,368,381,384],{},[44,379,380],{},"400",[44,382,383],{},"invalid_input"," — ungültiger Ereignisname, fehlendes Pflichtfeld oder fehlerhafter JSON-Body",[208,386,387,389],{},[44,388,84],{}," — fehlender oder ungültiger API-Key",[208,391,392,394,395],{},[44,393,91],{}," — dem Key fehlt der Scope ",[44,396,61],{},[208,398,399,401],{},[44,400,95],{}," — mehr als 10 Anfragen pro Sekunde",[403,404,405],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sYgZi, html code.shiki .sYgZi{--shiki-default:#24292E;--shiki-dark:#ADBAC7}html pre.shiki code .snmFh, html code.shiki .snmFh{--shiki-default:#005CC5;--shiki-dark:#8DDB8C}html pre.shiki code .s-HuK, html code.shiki .s-HuK{--shiki-default:#032F62;--shiki-dark:#96D0FF}html pre.shiki code .sviXB, html code.shiki .sviXB{--shiki-default:#005CC5;--shiki-dark:#6CB6FF}",{"title":69,"searchDepth":116,"depth":116,"links":407},[408,409,410,411,412],{"id":17,"depth":116,"text":18},{"id":54,"depth":116,"text":55},{"id":99,"depth":116,"text":100},{"id":261,"depth":116,"text":262},{"id":353,"depth":116,"text":354},"md",{},true,"\u002Fapi\u002Fevents",{"title":6,"description":13},"2.api\u002F7.events","ovrY_upqMD6hhTNn5CH8DXi_wD2NBklCVABeupnDv9g",[421,425],{"title":422,"path":423,"stem":424,"children":-1},"Themen-API","\u002Fapi\u002Ftopics","2.api\u002F6.topics",{"title":426,"path":427,"stem":428,"children":-1},"Transaktionale API","\u002Fapi\u002Ftransactional","2.api\u002F8.transactional",1786915106818]