{"_id":"590a04f4ed80861900cbc76a","version":{"_id":"590a04f2ed80861900cbc737","project":"55b2d5baa74a380d00e290c4","__v":4,"createdAt":"2017-05-03T16:27:30.085Z","releaseDate":"2017-05-03T16:27:30.085Z","categories":["590a04f3ed80861900cbc738","590a04f3ed80861900cbc739","590a04f3ed80861900cbc73a","590a04f3ed80861900cbc73b","590a04f3ed80861900cbc73c","590a04f3ed80861900cbc73d","590a04f3ed80861900cbc73e","590a04f3ed80861900cbc73f","590a04f3ed80861900cbc740","590a04f3ed80861900cbc741","590a04f3ed80861900cbc742","590a04f3ed80861900cbc743","590a04f3ed80861900cbc744","590a04f3ed80861900cbc745","590a04f3ed80861900cbc746","590a04f3ed80861900cbc747","590a04f3ed80861900cbc748","590a04f3ed80861900cbc749","590a04f3ed80861900cbc74a","590a04f3ed80861900cbc74b","590a04f3ed80861900cbc74c","590a04f3ed80861900cbc74d","59124949de13f61900336a7a","5914b04e7c2c552d008b7104","5914b47242c6a22300b9dc20"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"7.0.0","version":"7"},"__v":0,"category":{"_id":"590a04f3ed80861900cbc73e","project":"55b2d5baa74a380d00e290c4","version":"590a04f2ed80861900cbc737","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-11-14T01:14:16.514Z","from_sync":false,"order":6,"slug":"webhooks","title":"Webhooks"},"parentDoc":null,"project":"55b2d5baa74a380d00e290c4","user":"55b2d5626862a10d00887af9","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-04T21:58:02.318Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":8,"body":"A webhook notifies buddybuild of code changes you make to your repository. Whenever a new change is pushed, buddybuild will automatically build your app - ensuring you have up-to-date build status and your testers have the very latest changes.\n\nLet's get started!\n\nOn the **Builds** page you will notice a big red banner labelled *Looking for builds to be kicked off automatically?* To get started click the **Resolve this issue** button.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c08d7a6-Webhooks_-_resolve_banner.png\",\n        \"Webhooks - resolve banner.png\",\n        1500,\n        298,\n        \"#f8403f\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nIn the dialog box that appears, **select and copy the webhook URL.** This URL is specific to your app and will be used to identify your app when sending webhooks from Kiln.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1eff82e-Webhooks_-_modal.png\",\n        \"Webhooks - modal.png\",\n        1500,\n        838,\n        \"#535663\"\n      ]\n    }\n  ]\n}\n[/block]\nNavigate to your Kiln repository. On the top navigation bar, select **Settings.**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/frbJYFYsSTym1oK5hxoc_Screen%20Shot%202016-05-04%20at%205.48.00%20PM.png\",\n        \"Screen Shot 2016-05-04 at 5.48.00 PM.png\",\n        \"1924\",\n        \"633\",\n        \"#f2453d\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nClick the **web hooks** link under the section **Web Hooks**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/fEal9fQSt6LIr2voXD1w_Screen%20Shot%202016-05-04%20at%205.48.44%20PM.png\",\n        \"Screen Shot 2016-05-04 at 5.48.44 PM.png\",\n        \"2166\",\n        \"1193\",\n        \"#f2463d\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nClick the **Create a new web hook...** button.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/UQm5DnTSSKkwhOCewyEk_Screen%20Shot%202016-05-05%20at%2010.10.30%20AM.png\",\n        \"Screen Shot 2016-05-05 at 10.10.30 AM.png\",\n        \"2014\",\n        \"574\",\n        \"#f9413a\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nEnter a title for the web hook, and then set the web hook **Type** to **Custom**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/nfijaVVERlGKa6rIJqRV_Screen%20Shot%202016-05-04%20at%205.50.18%20PM.png\",\n        \"Screen Shot 2016-05-04 at 5.50.18 PM.png\",\n        \"2565\",\n        \"1131\",\n        \"#f73e3b\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nPaste the URL you first copied into the **URL** field.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ecJUYhuwSEynDwmTFc7T_Screen%20Shot%202016-05-04%20at%205.51.27%20PM.png\",\n        \"Screen Shot 2016-05-04 at 5.51.27 PM.png\",\n        \"1711\",\n        \"532\",\n        \"#fb3c3c\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nIn the **Repositories** field, start typing the name of your repository, then select it. Remember that the buddybuild webhook url is specific to your app, so you must create a new web hook in Kiln for each app, even if your repository contains multiple apps.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1eJBBCEcTNery9MXUlGO_Screen%20Shot%202016-05-04%20at%205.51.27%20PM%20copy.png\",\n        \"Screen Shot 2016-05-04 at 5.51.27 PM copy.png\",\n        \"1627\",\n        \"320\",\n        \"#173f62\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nFinally, click the **Create web hook** button. You're now done!\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/l8ekMHcKTMGas5LYAFPl_Screen%20Shot%202016-05-04%20at%205.51.34%20PM.png\",\n        \"Screen Shot 2016-05-04 at 5.51.34 PM.png\",\n        \"1633\",\n        \"453\",\n        \"#234869\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"adding-a-kiln-webhook","type":"basic","title":"Adding a Kiln Webhook"}

Adding a Kiln Webhook


A webhook notifies buddybuild of code changes you make to your repository. Whenever a new change is pushed, buddybuild will automatically build your app - ensuring you have up-to-date build status and your testers have the very latest changes. Let's get started! On the **Builds** page you will notice a big red banner labelled *Looking for builds to be kicked off automatically?* To get started click the **Resolve this issue** button. [block:image] { "images": [ { "image": [ "https://files.readme.io/c08d7a6-Webhooks_-_resolve_banner.png", "Webhooks - resolve banner.png", 1500, 298, "#f8403f" ], "sizing": "full" } ] } [/block] In the dialog box that appears, **select and copy the webhook URL.** This URL is specific to your app and will be used to identify your app when sending webhooks from Kiln. [block:image] { "images": [ { "image": [ "https://files.readme.io/1eff82e-Webhooks_-_modal.png", "Webhooks - modal.png", 1500, 838, "#535663" ] } ] } [/block] Navigate to your Kiln repository. On the top navigation bar, select **Settings.** [block:image] { "images": [ { "image": [ "https://files.readme.io/frbJYFYsSTym1oK5hxoc_Screen%20Shot%202016-05-04%20at%205.48.00%20PM.png", "Screen Shot 2016-05-04 at 5.48.00 PM.png", "1924", "633", "#f2453d", "" ], "sizing": "full" } ] } [/block] Click the **web hooks** link under the section **Web Hooks**. [block:image] { "images": [ { "image": [ "https://files.readme.io/fEal9fQSt6LIr2voXD1w_Screen%20Shot%202016-05-04%20at%205.48.44%20PM.png", "Screen Shot 2016-05-04 at 5.48.44 PM.png", "2166", "1193", "#f2463d", "" ], "sizing": "full" } ] } [/block] Click the **Create a new web hook...** button. [block:image] { "images": [ { "image": [ "https://files.readme.io/UQm5DnTSSKkwhOCewyEk_Screen%20Shot%202016-05-05%20at%2010.10.30%20AM.png", "Screen Shot 2016-05-05 at 10.10.30 AM.png", "2014", "574", "#f9413a", "" ] } ] } [/block] Enter a title for the web hook, and then set the web hook **Type** to **Custom**. [block:image] { "images": [ { "image": [ "https://files.readme.io/nfijaVVERlGKa6rIJqRV_Screen%20Shot%202016-05-04%20at%205.50.18%20PM.png", "Screen Shot 2016-05-04 at 5.50.18 PM.png", "2565", "1131", "#f73e3b", "" ] } ] } [/block] Paste the URL you first copied into the **URL** field. [block:image] { "images": [ { "image": [ "https://files.readme.io/ecJUYhuwSEynDwmTFc7T_Screen%20Shot%202016-05-04%20at%205.51.27%20PM.png", "Screen Shot 2016-05-04 at 5.51.27 PM.png", "1711", "532", "#fb3c3c", "" ], "sizing": "full" } ] } [/block] In the **Repositories** field, start typing the name of your repository, then select it. Remember that the buddybuild webhook url is specific to your app, so you must create a new web hook in Kiln for each app, even if your repository contains multiple apps. [block:image] { "images": [ { "image": [ "https://files.readme.io/1eJBBCEcTNery9MXUlGO_Screen%20Shot%202016-05-04%20at%205.51.27%20PM%20copy.png", "Screen Shot 2016-05-04 at 5.51.27 PM copy.png", "1627", "320", "#173f62", "" ], "sizing": "full" } ] } [/block] Finally, click the **Create web hook** button. You're now done! [block:image] { "images": [ { "image": [ "https://files.readme.io/l8ekMHcKTMGas5LYAFPl_Screen%20Shot%202016-05-04%20at%205.51.34%20PM.png", "Screen Shot 2016-05-04 at 5.51.34 PM.png", "1633", "453", "#234869", "" ] } ] } [/block]