[{"data":1,"prerenderedAt":599},["ShallowReactive",2],{"search-de":3,"content-de-api\u002Fcontacts":4,"surround-de-\u002Fapi\u002Fcontacts":590},[],{"id":5,"title":6,"body":7,"description":13,"extension":583,"meta":584,"navigation":585,"path":586,"seo":587,"stem":588,"__hash__":589},"content_de\u002F2.api\u002F5.contacts.md","Kontakte-API",{"type":8,"value":9,"toc":574},"minimark",[10,14,19,114,117,125,141,144,177,180,284,308,311,320,323,370,377,381,387,398,402,411,414,418,427,461,465,570],[11,12,13],"p",{},"Kontakte Ihrer Organisation verwalten.",[15,16,18],"h2",{"id":17},"endpunkte","Endpunkte",[20,21,22,38],"table",{},[23,24,25],"thead",{},[26,27,28,32,35],"tr",{},[29,30,31],"th",{},"Methode",[29,33,34],{},"Pfad",[29,36,37],{},"Beschreibung",[39,40,41,58,72,86,100],"tbody",{},[26,42,43,50,55],{},[44,45,46],"td",{},[47,48,49],"code",{},"GET",[44,51,52],{},[47,53,54],{},"\u002Fapi\u002Fv1\u002Fcontacts",[44,56,57],{},"Kontakte auflisten",[26,59,60,65,69],{},[44,61,62],{},[47,63,64],{},"POST",[44,66,67],{},[47,68,54],{},[44,70,71],{},"Kontakt anlegen",[26,73,74,78,83],{},[44,75,76],{},[47,77,49],{},[44,79,80],{},[47,81,82],{},"\u002Fapi\u002Fv1\u002Fcontacts\u002F:id",[44,84,85],{},"Abruf über Kontakt-ID oder E-Mail",[26,87,88,93,97],{},[44,89,90],{},[47,91,92],{},"PUT",[44,94,95],{},[47,96,82],{},[44,98,99],{},"Aktualisierung über Kontakt-ID oder E-Mail",[26,101,102,107,111],{},[44,103,104],{},[47,105,106],{},"DELETE",[44,108,109],{},[47,110,82],{},[44,112,113],{},"Löschung über Kontakt-ID oder E-Mail",[15,115,57],{"id":116},"kontakte-auflisten",[11,118,119,120,124],{},"Kontakte werden ",[121,122,123],"strong",{},"Cursor-paginiert",". Es gibt keine Zeilenobergrenze — jeder Kontakt ist\nerreichbar, und Suchergebnisse erstrecken sich tatsächlich über mehrere Seiten (nach Relevanz sortiert).",[126,127,132],"pre",{"className":128,"code":129,"language":130,"meta":131,"style":131},"language-http shiki shiki-themes github-light github-dark-dimmed","GET \u002Fapi\u002Fv1\u002Fcontacts?limit=25&search=jane\n","http","",[47,133,134],{"__ignoreMap":131},[135,136,139],"span",{"class":137,"line":138},"line",1,[135,140,129],{},[11,142,143],{},"Query-Parameter:",[145,146,147,162,172],"ul",{},[148,149,150,153,154,157,158,161],"li",{},[47,151,152],{},"limit"," (max. ",[47,155,156],{},"100",", Standard ",[47,159,160],{},"25",")",[148,163,164,167,168,171],{},[47,165,166],{},"cursor"," — opaker Fortsetzungs-Cursor aus dem Feld ",[47,169,170],{},"pagination.cursor"," der\nvorherigen Antwort. Lassen Sie ihn weg, um die erste Seite abzurufen.",[148,173,174],{},[47,175,176],{},"search",[11,178,179],{},"Antwort:",[126,181,185],{"className":182,"code":183,"language":184,"meta":131,"style":131},"language-json shiki shiki-themes github-light github-dark-dimmed","{\n  \"data\": [ \u002F* …contacts… *\u002F ],\n  \"pagination\": {\n    \"limit\": 25,\n    \"totalItems\": 1342,\n    \"cursor\": \"opaque-cursor-string\",\n    \"isDone\": false\n  }\n}\n","json",[47,186,187,193,210,219,234,247,261,272,278],{"__ignoreMap":131},[135,188,189],{"class":137,"line":138},[135,190,192],{"class":191},"sYgZi","{\n",[135,194,196,200,203,207],{"class":137,"line":195},2,[135,197,199],{"class":198},"snmFh","  \"data\"",[135,201,202],{"class":191},": [ ",[135,204,206],{"class":205},"sDN9O","\u002F* …contacts… *\u002F",[135,208,209],{"class":191}," ],\n",[135,211,213,216],{"class":137,"line":212},3,[135,214,215],{"class":198},"  \"pagination\"",[135,217,218],{"class":191},": {\n",[135,220,222,225,228,231],{"class":137,"line":221},4,[135,223,224],{"class":198},"    \"limit\"",[135,226,227],{"class":191},": ",[135,229,160],{"class":230},"sviXB",[135,232,233],{"class":191},",\n",[135,235,237,240,242,245],{"class":137,"line":236},5,[135,238,239],{"class":198},"    \"totalItems\"",[135,241,227],{"class":191},[135,243,244],{"class":230},"1342",[135,246,233],{"class":191},[135,248,250,253,255,259],{"class":137,"line":249},6,[135,251,252],{"class":198},"    \"cursor\"",[135,254,227],{"class":191},[135,256,258],{"class":257},"s-HuK","\"opaque-cursor-string\"",[135,260,233],{"class":191},[135,262,264,267,269],{"class":137,"line":263},7,[135,265,266],{"class":198},"    \"isDone\"",[135,268,227],{"class":191},[135,270,271],{"class":230},"false\n",[135,273,275],{"class":137,"line":274},8,[135,276,277],{"class":191},"  }\n",[135,279,281],{"class":137,"line":280},9,[135,282,283],{"class":191},"}\n",[11,285,286,287,289,290,292,293,296,297,300,301,303,304,307],{},"Um alle Seiten zu durchlaufen, rufen Sie den Endpunkt wiederholt mit ",[47,288,166],{}," auf, gesetzt auf das\n",[47,291,170],{}," der vorherigen Antwort, bis ",[47,294,295],{},"pagination.isDone"," den Wert ",[47,298,299],{},"true"," hat (ab da ist ",[47,302,166],{},"\ngleich ",[47,305,306],{},"null",").",[15,309,71],{"id":310},"kontakt-anlegen",[126,312,314],{"className":128,"code":313,"language":130,"meta":131,"style":131},"POST \u002Fapi\u002Fv1\u002Fcontacts\n",[47,315,316],{"__ignoreMap":131},[135,317,318],{"class":137,"line":138},[135,319,313],{},[11,321,322],{},"Body:",[126,324,326],{"className":182,"code":325,"language":184,"meta":131,"style":131},"{\n  \"email\": \"jane@example.com\",\n  \"firstName\": \"Jane\",\n  \"lastName\": \"Smith\"\n}\n",[47,327,328,332,344,356,366],{"__ignoreMap":131},[135,329,330],{"class":137,"line":138},[135,331,192],{"class":191},[135,333,334,337,339,342],{"class":137,"line":195},[135,335,336],{"class":198},"  \"email\"",[135,338,227],{"class":191},[135,340,341],{"class":257},"\"jane@example.com\"",[135,343,233],{"class":191},[135,345,346,349,351,354],{"class":137,"line":212},[135,347,348],{"class":198},"  \"firstName\"",[135,350,227],{"class":191},[135,352,353],{"class":257},"\"Jane\"",[135,355,233],{"class":191},[135,357,358,361,363],{"class":137,"line":221},[135,359,360],{"class":198},"  \"lastName\"",[135,362,227],{"class":191},[135,364,365],{"class":257},"\"Smith\"\n",[135,367,368],{"class":137,"line":236},[135,369,283],{"class":191},[11,371,372,373,376],{},"Liefert ",[47,374,375],{},"201"," mit dem angelegten Kontakt zurück.",[15,378,380],{"id":379},"kontakt-abrufen","Kontakt abrufen",[11,382,383,386],{},[47,384,385],{},"id"," kann entweder sein:",[145,388,389,392],{},[148,390,391],{},"eine Convex-Kontakt-ID",[148,393,394,395,161],{},"eine URL-kodierte E-Mail-Adresse (zum Beispiel ",[47,396,397],{},"jane%40example.com",[15,399,401],{"id":400},"kontakt-aktualisieren","Kontakt aktualisieren",[126,403,405],{"className":128,"code":404,"language":130,"meta":131,"style":131},"PUT \u002Fapi\u002Fv1\u002Fcontacts\u002F:id\n",[47,406,407],{"__ignoreMap":131},[135,408,409],{"class":137,"line":138},[135,410,404],{},[11,412,413],{},"Teilweise Aktualisierungen werden unterstützt.",[15,415,417],{"id":416},"kontakt-löschen","Kontakt löschen",[126,419,421],{"className":128,"code":420,"language":130,"meta":131,"style":131},"DELETE \u002Fapi\u002Fv1\u002Fcontacts\u002F:id\n",[47,422,423],{"__ignoreMap":131},[135,424,425],{"class":137,"line":138},[135,426,420],{},[428,429,432],"callout",{"title":430,"type":431},"Eigene Eigenschaften","info",[11,433,434,435,438,439,442,443,438,446,438,449,438,452,438,455,438,458,307],{},"Eigene Kontakteigenschaften (etwa ",[47,436,437],{},"language",", ",[47,440,441],{},"timezone"," sowie selbst definierte Felder) werden über das Dashboard verwaltet. Die REST-API verarbeitet derzeit ausschließlich die zentralen Kontaktfelder (",[47,444,445],{},"email",[47,447,448],{},"firstName",[47,450,451],{},"lastName",[47,453,454],{},"source",[47,456,457],{},"createdAt",[47,459,460],{},"updatedAt",[15,462,464],{"id":463},"struktur-der-kontakt-antwort","Struktur der Kontakt-Antwort",[126,466,468],{"className":182,"code":467,"language":184,"meta":131,"style":131},"{\n  \"data\": {\n    \"id\": \"j57...\",\n    \"email\": \"jane@example.com\",\n    \"firstName\": \"Jane\",\n    \"lastName\": \"Smith\",\n    \"source\": \"api\",\n    \"createdAt\": \"2026-02-17T14:00:00.000Z\",\n    \"updatedAt\": \"2026-02-17T14:00:00.000Z\"\n  }\n}\n",[47,469,470,474,480,492,503,514,526,538,550,560,565],{"__ignoreMap":131},[135,471,472],{"class":137,"line":138},[135,473,192],{"class":191},[135,475,476,478],{"class":137,"line":195},[135,477,199],{"class":198},[135,479,218],{"class":191},[135,481,482,485,487,490],{"class":137,"line":212},[135,483,484],{"class":198},"    \"id\"",[135,486,227],{"class":191},[135,488,489],{"class":257},"\"j57...\"",[135,491,233],{"class":191},[135,493,494,497,499,501],{"class":137,"line":221},[135,495,496],{"class":198},"    \"email\"",[135,498,227],{"class":191},[135,500,341],{"class":257},[135,502,233],{"class":191},[135,504,505,508,510,512],{"class":137,"line":236},[135,506,507],{"class":198},"    \"firstName\"",[135,509,227],{"class":191},[135,511,353],{"class":257},[135,513,233],{"class":191},[135,515,516,519,521,524],{"class":137,"line":249},[135,517,518],{"class":198},"    \"lastName\"",[135,520,227],{"class":191},[135,522,523],{"class":257},"\"Smith\"",[135,525,233],{"class":191},[135,527,528,531,533,536],{"class":137,"line":263},[135,529,530],{"class":198},"    \"source\"",[135,532,227],{"class":191},[135,534,535],{"class":257},"\"api\"",[135,537,233],{"class":191},[135,539,540,543,545,548],{"class":137,"line":274},[135,541,542],{"class":198},"    \"createdAt\"",[135,544,227],{"class":191},[135,546,547],{"class":257},"\"2026-02-17T14:00:00.000Z\"",[135,549,233],{"class":191},[135,551,552,555,557],{"class":137,"line":280},[135,553,554],{"class":198},"    \"updatedAt\"",[135,556,227],{"class":191},[135,558,559],{"class":257},"\"2026-02-17T14:00:00.000Z\"\n",[135,561,563],{"class":137,"line":562},10,[135,564,277],{"class":191},[135,566,568],{"class":137,"line":567},11,[135,569,283],{"class":191},[571,572,573],"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 .sDN9O, html code.shiki .sDN9O{--shiki-default:#6A737D;--shiki-dark:#768390}html pre.shiki code .sviXB, html code.shiki .sviXB{--shiki-default:#005CC5;--shiki-dark:#6CB6FF}html pre.shiki code .s-HuK, html code.shiki .s-HuK{--shiki-default:#032F62;--shiki-dark:#96D0FF}",{"title":131,"searchDepth":195,"depth":195,"links":575},[576,577,578,579,580,581,582],{"id":17,"depth":195,"text":18},{"id":116,"depth":195,"text":57},{"id":310,"depth":195,"text":71},{"id":379,"depth":195,"text":380},{"id":400,"depth":195,"text":401},{"id":416,"depth":195,"text":417},{"id":463,"depth":195,"text":464},"md",{},true,"\u002Fapi\u002Fcontacts",{"title":6,"description":13},"2.api\u002F5.contacts","wAFiVEbC0uKnsdZCeXchSgEJcwClihZPPEZFrCuc10U",[591,595],{"title":592,"path":593,"stem":594,"children":-1},"Java-SDK","\u002Fapi\u002Fsdk-java","2.api\u002F4.sdk-java",{"title":596,"path":597,"stem":598,"children":-1},"Themen-API","\u002Fapi\u002Ftopics","2.api\u002F6.topics",1786915106734]