[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-en-\u002Fen\u002Fdocs\u002Fapi\u002Finbound-webhooks":3},{"id":4,"title":5,"body":6,"category":594,"code_examples":595,"demos":595,"description":596,"extension":597,"meta":598,"navigation":595,"order":599,"path":600,"seo":601,"sitemap":604,"stem":606,"tags":607,"toc":614,"videos":595,"__hash__":615},"docsEn\u002Fen\u002Fdocs\u002Fapi\u002Finbound-webhooks.md","Incoming Webhooks - Add Leads from Zapier, Make, n8n, and Forms",{"type":7,"value":8,"toc":579},"minimark",[9,14,18,21,35,40,53,57,90,97,101,104,131,134,137,142,248,259,262,266,276,282,325,328,345,349,405,409,540,543,547,564,568],[10,11,13],"h1",{"id":12},"incoming-webhooks","Incoming Webhooks",[15,16,17],"p",{},"An incoming webhook is a secret address. Another tool posts data to it. Konektor reads the post and adds a lead, or updates a lead that already exists.",[15,19,20],{},"Use it with Zapier, Make, n8n, a form builder, or a CRM. You do not need an API key.",[15,22,23,24,29,30,34],{},"For the other direction, where Konektor sends events to your tool, read ",[25,26,28],"a",{"href":27},"\u002Fen\u002Fdocs\u002Fapi\u002Fwebhooks","Webhooks",". For step-by-step guides, read ",[25,31,33],{"href":32},"\u002Fen\u002Fdocs\u002Fapi\u002Fzapier-make-n8n","Zapier, Make, and n8n",".",[36,37,39],"h2",{"id":38},"requirements","Requirements",[41,42,43,47,50],"ul",{},[44,45,46],"li",{},"You are the workspace owner.",[44,48,49],{},"The plan includes the API: Pro, Enterprise, or a Custom plan that turns it on. Trial and Starter do not include incoming webhooks.",[44,51,52],{},"The workspace has fewer incoming webhooks than the plan allows: 20 on Pro and Custom, and 50 on Enterprise.",[36,54,56],{"id":55},"create-an-incoming-webhook","Create an incoming webhook",[58,59,60,67,77,83],"ol",{},[44,61,62,63,34],{},"Open ",[64,65,66],"strong",{},"API & Webhooks",[44,68,69,70,73,74,34],{},"In ",[64,71,72],{},"Incoming webhooks",", select ",[64,75,76],{},"Add incoming webhook",[44,78,79,80,34],{},"Enter a name that tells you which tool sends the leads, then select ",[64,81,82],{},"Create",[44,84,85,86,34],{},"Copy the address. It looks like ",[87,88,89],"code",{},"https:\u002F\u002Fkonektor.id\u002Fapi\u002Fhooks\u002Fin\u002F...",[15,91,92,93,96],{},"Anyone who has the address can add leads. Keep it private. To read it again, open the menu of the webhook and select ",[64,94,95],{},"Show address",". Only the owner can do this.",[36,98,100],{"id":99},"send-a-test-post-and-choose-the-fields","Send a test post and choose the fields",[15,102,103],{},"Konektor does not know the shape of your data until it sees one post.",[58,105,106,116,119,122,125],{},[44,107,108,109,112,113,34],{},"Select ",[64,110,111],{},"Set up"," on the webhook, then select ",[64,114,115],{},"Wait for a test post",[44,117,118],{},"Send one test post from your tool to the address. Use real-looking data.",[44,120,121],{},"Konektor keeps this post as an example and lists its fields. This post does not make a lead.",[44,123,124],{},"For each lead field, choose the field of your post that fills it.",[44,126,127,128,34],{},"Set the defaults and the match field (see below), then select ",[64,129,130],{},"Save",[15,132,133],{},"The editor waits for 2 minutes. If no post arrives, select the button again. A new test post replaces the old example.",[15,135,136],{},"Choose at least a name, a phone number, or an email.",[138,139,141],"h3",{"id":140},"lead-fields","Lead fields",[143,144,145,158],"table",{},[146,147,148],"thead",{},[149,150,151,155],"tr",{},[152,153,154],"th",{},"Lead field",[152,156,157],{},"What it fills",[159,160,161,170,178,186,202,216,224,232,240],"tbody",{},[149,162,163,167],{},[164,165,166],"td",{},"Name",[164,168,169],{},"The first word becomes the first name. The rest becomes the last name.",[149,171,172,175],{},[164,173,174],{},"Phone",[164,176,177],{},"The phone number. Up to 20 characters.",[149,179,180,183],{},[164,181,182],{},"Email",[164,184,185],{},"The email address. It must be a valid address.",[149,187,188,191],{},[164,189,190],{},"Status",[164,192,193,194,197,198,201],{},"A lead status such as ",[87,195,196],{},"new"," or ",[87,199,200],{},"qualified",". An unknown value is ignored, and the default applies.",[149,203,204,207],{},[164,205,206],{},"Source",[164,208,209,210,197,213,201],{},"A lead source such as ",[87,211,212],{},"website",[87,214,215],{},"ads",[149,217,218,221],{},[164,219,220],{},"Value",[164,222,223],{},"The estimated value. A number, or text with digits only.",[149,225,226,229],{},[164,227,228],{},"Notes",[164,230,231],{},"Free text. Up to 5000 characters.",[149,233,234,237],{},[164,235,236],{},"Reference from the other tool",[164,238,239],{},"An ID from the other tool. Up to 150 characters.",[149,241,242,245],{},[164,243,244],{},"UTM source, medium, campaign, term, content",[164,246,247],{},"Campaign tags. Up to 200 characters each.",[15,249,250,251,254,255,258],{},"A path points to a field inside the post. Use dots to go deeper: ",[87,252,253],{},"contact.email",". Use a number for a list item: ",[87,256,257],{},"items.0.sku",". Konektor shows the paths of your test post, so you only choose from a list.",[15,260,261],{},"If a post has no name, Konektor uses the email name or the phone number as the first name.",[36,263,265],{"id":264},"defaults-and-existing-leads","Defaults and existing leads",[15,267,268,271,272,275],{},[64,269,270],{},"Source for a new lead"," and ",[64,273,274],{},"Status for a new lead"," apply when the post does not carry them. They never change a lead that already exists.",[15,277,278,281],{},[64,279,280],{},"Find an existing lead by"," decides what happens when a post arrives:",[143,283,284,294],{},[146,285,286],{},[149,287,288,291],{},[152,289,290],{},"Match",[152,292,293],{},"Result",[159,295,296,304,311,318],{},[149,297,298,301],{},[164,299,300],{},"Nothing",[164,302,303],{},"Every post makes a new lead.",[149,305,306,308],{},[164,307,236],{},[164,309,310],{},"A lead with the same reference is updated.",[149,312,313,315],{},[164,314,174],{},[164,316,317],{},"A lead with the same phone number is updated.",[149,319,320,322],{},[164,321,182],{},[164,323,324],{},"A lead with the same email is updated.",[15,326,327],{},"If no lead matches, Konektor makes a new one. If you map a reference and set no match, a post with a reference that already exists updates that lead, so a retry does not make a double.",[15,329,330,331,271,334,337,338,341,342,34],{},"An update changes only the fields that you mapped. A lead created or changed this way also sends your outgoing ",[87,332,333],{},"lead.created",[87,335,336],{},"lead.updated"," webhooks, with ",[87,339,340],{},"source"," set to ",[87,343,344],{},"inbound_webhook",[36,346,348],{"id":347},"what-the-address-accepts","What the address accepts",[143,350,351,361],{},[146,352,353],{},[149,354,355,358],{},[152,356,357],{},"Item",[152,359,360],{},"Rule",[159,362,363,373,389,397],{},[149,364,365,368],{},[164,366,367],{},"Method",[164,369,370],{},[87,371,372],{},"POST",[149,374,375,378],{},[164,376,377],{},"Body",[164,379,380,381,384,385,388],{},"JSON (",[87,382,383],{},"application\u002Fjson",") or form data (",[87,386,387],{},"application\u002Fx-www-form-urlencoded",").",[149,390,391,394],{},[164,392,393],{},"Size",[164,395,396],{},"Up to 64 KB.",[149,398,399,402],{},[164,400,401],{},"Speed",[164,403,404],{},"Up to 60 posts per minute from one IP address.",[36,406,408],{"id":407},"answers","Answers",[143,410,411,420],{},[146,412,413],{},[149,414,415,417],{},[152,416,190],{},[152,418,419],{},"Meaning",[159,421,422,446,458,470,480,490,500,510,520,530],{},[149,423,424,433],{},[164,425,426,429,430],{},[87,427,428],{},"202"," with ",[87,431,432],{},"\"lead_id\"",[164,434,435,436,439,440,197,443,34],{},"The lead was made or updated. ",[87,437,438],{},"\"action\""," is ",[87,441,442],{},"created",[87,444,445],{},"updated",[149,447,448,455],{},[164,449,450,429,452],{},[87,451,428],{},[87,453,454],{},"\"captured\": true",[164,456,457],{},"The post was kept as the test example. No lead was made.",[149,459,460,467],{},[164,461,462,429,464],{},[87,463,428],{},[87,465,466],{},"\"mapped\": false",[164,468,469],{},"The webhook has no field setup yet. No lead was made.",[149,471,472,477],{},[164,473,474],{},[87,475,476],{},"404",[164,478,479],{},"The address is wrong, off, deleted, or not available on the plan. All of these give the same answer.",[149,481,482,487],{},[164,483,484],{},[87,485,486],{},"409",[164,488,489],{},"The post matches a lead that already exists and cannot be added again.",[149,491,492,497],{},[164,493,494],{},[87,495,496],{},"413",[164,498,499],{},"The body is larger than 64 KB.",[149,501,502,507],{},[164,503,504],{},[87,505,506],{},"415",[164,508,509],{},"The body is not JSON or form data.",[149,511,512,517],{},[164,513,514],{},[87,515,516],{},"422",[164,518,519],{},"The post has no name, phone, or email, or a value that a lead cannot hold.",[149,521,522,527],{},[164,523,524],{},[87,525,526],{},"429",[164,528,529],{},"The daily lead limit of the workspace is full, or the address was called too often.",[149,531,532,537],{},[164,533,534],{},[87,535,536],{},"503",[164,538,539],{},"Konektor could not save the post now. Send it again.",[15,541,542],{},"The webhook card shows the time of the last post, how many posts arrived, and the reason of the last failure.",[36,544,546],{"id":545},"change-or-stop-an-address","Change or stop an address",[41,548,549,555,561],{},[44,550,551,552,554],{},"Use the switch to turn an address off. It answers ",[87,553,476],{}," until you turn it on again.",[44,556,108,557,560],{},[64,558,559],{},"Make a new address"," if the address leaked. The old address stops at once. Paste the new address in your tool.",[44,562,563],{},"Delete the webhook to remove it. This cannot be undone.",[36,565,567],{"id":566},"manage-from-claude-and-the-agent-api","Manage from Claude and the Agent API",[15,569,570,571,271,575,34],{},"Claude and AI agents can list, create, edit, and delete incoming webhooks after you agree, and can read the field list of the test post. They never see the values of the test post. See ",[25,572,574],{"href":573},"\u002Fen\u002Fdocs\u002Fapi\u002Fagent-api","Agent API",[25,576,578],{"href":577},"\u002Fen\u002Fdocs\u002Fapi\u002Fclaude-connector","Claude connector",{"title":580,"searchDepth":581,"depth":581,"links":582},"",2,[583,584,585,589,590,591,592,593],{"id":38,"depth":581,"text":39},{"id":55,"depth":581,"text":56},{"id":99,"depth":581,"text":100,"children":586},[587],{"id":140,"depth":588,"text":141},3,{"id":264,"depth":581,"text":265},{"id":347,"depth":581,"text":348},{"id":407,"depth":581,"text":408},{"id":545,"depth":581,"text":546},{"id":566,"depth":581,"text":567},"api",null,"Create a secret address, send a test post, map its fields to lead fields, and let any tool add or update leads in Konektor.","md",{},6,"\u002Fen\u002Fdocs\u002Fapi\u002Finbound-webhooks",{"title":602,"description":603,"canonical":600},"Konektor Incoming Webhooks - Add Leads from Any Tool","Guide to incoming webhooks: create the address, capture a sample post, map fields, match existing leads, limits, and error answers.",{"loc":600,"lastmod":605},"2026-10-14","en\u002Fdocs\u002Fapi\u002Finbound-webhooks",[608,609,610,611,612,613],"webhooks","incoming","zapier","make","n8n","leads",true,"vFSxtUT4tMjLUBEcLp23FHMqaV6DwS3rHihWdifV93g"]