{"_id":"5a96c701c777af00359e86b0","project":"568bdc1483d2061900d86cdc","version":{"_id":"59a72290d61777001b6c42c3","project":"568bdc1483d2061900d86cdc","__v":33,"createdAt":"2017-08-30T20:39:44.453Z","releaseDate":"2017-08-30T20:39:44.453Z","categories":["59a7236e3fe4d90025117c10","59a72eb6cb0db3001b84cfe2","59a734eb757d030019b85af8","59c0243b1b2d07001a9d2b76","59c035e42126e10028effb12","59c06c40df5b3c0010584a13","59c1a5852cabe5002641a3e7","59c2fb00b2b45c0010b7a3d7","59c32ceb9aea850010ac4130","59c32e6e190c90003cb0d12f","59c33affb2b45c0010b7aa23","59c7dfa457bd8200105444dc","59c7e975c50cf30010d712a0","59cffdef0cd4dd0010294d54","59d0622ca91a810032c8f60c","59d06733c1aec60026253065","59d174d44ac471001a07b123","59d5a5e323e6e800103defb2","59ecf1d8ed507c001c52b255","59f76fef8581dc0010593e6f","5a0c003680a35b0012c35db0","5a8358722e78660075e45f42","5a846645b5ec3a001203517e","5b258091bc7a6700033b9cb5","5b26e48e024807000315a740","5b44edff3306680003663f5c","5b468abd3d4a9e0003789111","5b468d8f3dcb6a0003c6e374","5b47b0b93d4a9e000378a33a","5b538d114ea24f00033c726f","5b6a0efe402b32000336c33f","5bba5e5d7ba7710003bd902a","5bc2703349ac3a0013eec3e5"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"0.0.0","version":"0"},"category":{"_id":"59c7dfa457bd8200105444dc","project":"568bdc1483d2061900d86cdc","version":"59a72290d61777001b6c42c3","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-09-24T16:39:00.936Z","from_sync":false,"order":26,"slug":"webhooks-api","title":"Webhooks API"},"user":"5a6a26281895510045b2cd40","githubsync":"","__v":16,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-02-28T15:13:05.348Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"method":"post","examples":{"codes":[{"language":"http","code":"POST https://ioe.droplit.io/api/webhooks HTTP/1.1\nauthorization: AUTH_TOKEN\nContent-Type: application/json\n\n{\n\t\"ecosystemId\": \"C5156b8ace57896adb6dae592\",\n\t\"url\": \"https://requestb.in/12rm425t\",\n\t\"secret\": \"superSecret\",\n\t\"description\": \"very descriptive\",\n  \"serviceNotificationSet\": false,\n  \"serviceNotificationInfo\": false\n}"},{"code":"droplit.webhooks.create(\"C5156b8ace57896adb6dae592\", \"https://requestb.in/12rm425t\", \"very descriptive\", \"superSecret\", 2, {\"set\" : false, \"info\" : false} );","language":"javascript","name":"Droplit SDK - Example"},{"code":"","language":"text","name":"Droplit SDK - Reference"}]},"results":{"codes":[{"name":"","code":"{\n    \"id\": \"5a96c7ea25087217c40a30c0\",\n    \"ecosystemId\": \"C5156b8ace57896adb6dae592\",\n    \"url\": \"https://requestb.in/12rm425t\",\n    \"secret\": \"superSecret\",\n    \"description\": \"very descriptive\",\n    \"disabled\": false,\n    \"createdAt\": \"2018-02-28T15:16:58.941Z\",\n    \"serviceNotificationsEnabled\": true,\n    \"dataNotificationsEnabled\": false,\n    \"serviceNotificationEvent\": true,\n    \"serviceNotificationGet\": true,\n    \"serviceNotificationSet\": false,\n    \"serviceNotificationCall\": true,\n    \"serviceNotificationChanged\": true,\n    \"serviceNotificationInfo\": false,\n    \"serviceNotificationError\": true,\n    \"dataNotificationCreated\": true,\n    \"dataNotificationUpdated\": true,\n    \"dataNotificationDeleted\": true,\n    \"version\": 2\n}","language":"json","status":201},{"name":"Body Parameters Missing","code":"{\n    \"errorType\": \"InvalidParams\",\n    \"errors\": [\n        {\n            \"in\": \"body\",\n            \"message\": \"field is required\",\n            \"path\": \"url\"\n        }\n    ]\n}","language":"json","status":400},{"code":"{\n    \"errorType\": \"InvalidParams\",\n    \"errors\": [\n        {\n            \"in\": \"body\",\n            \"message\": \"invalid id\",\n            \"path\": \"ecosystemId\"\n        }\n    ]\n}","language":"json","status":400,"name":"Ecosystem Invalid"},{"code":"{\n    \"errorType\": \"InvalidParams\",\n    \"errors\": [\n        {\n            \"in\": \"body\",\n            \"message\": \"url did not match the pattern ^(?:https?:\\\\/\\\\/)?(?:.+\\\\.)?.+\\\\..+?(?:\\\\/.+)*$\",\n            \"path\": \"url\"\n        }\n    ]\n}","language":"json","status":400,"name":"Webhook Callback Invalid"},{"code":"Ecosystem with id C59e88eae258a6bf402e39d21 does not exist.","language":"text","status":404,"name":"Ecosystem Not Found"}]},"settings":"59a85bd52bdf3600193d4fd5","auth":"required","params":[{"_id":"59c7e07a57bd8200105444e1","ref":"","in":"body","required":true,"desc":"ID of the ecosystem in which the webhook will be created","default":"","type":"string","name":"ecosystemId"},{"_id":"59c7e07a57bd8200105444e0","ref":"","in":"body","required":true,"desc":"The target URL of the webhook","default":"","type":"string","name":"url"},{"_id":"59c7e07a57bd8200105444df","ref":"","in":"body","required":false,"desc":"Key with which hashes are generated","default":"","type":"string","name":"secret"},{"_id":"59c7e07a57bd8200105444de","ref":"","in":"body","required":false,"desc":"Brief description of webhook","default":"","type":"string","name":"description"},{"_id":"5a96d01e89442e0020410ce0","ref":"","in":"header","required":true,"desc":"The user's authorization token","default":"","type":"string","name":"authorization"},{"_id":"5a96d01e89442e0020410cdf","ref":"","in":"header","required":true,"desc":"Specify that the sent data will be a JSON object","default":"","type":"string","name":"Content-Type"},{"_id":"5ac4ec52bf58d30028807f88","ref":"","in":"body","required":false,"desc":"Enables selective service notifications, otherwise disables ALL service notifications (even if any specific types are enabled).","default":"true","type":"boolean","name":"serviceNotificationsEnabled"},{"_id":"5ac4ec52bf58d30028807f87","ref":"","in":"body","required":false,"desc":"Enables selective service notifications, otherwise disables ALL data notifications (even if some specific types are enabled).","default":"false","type":"boolean","name":"dataNotificationsEnabled"},{"_id":"5ac4ec52bf58d30028807f86","ref":"","in":"body","required":false,"desc":"Notifies when any service notification is sent.","default":"true","type":"boolean","name":"serviceNotificationEvent"},{"_id":"5ac4ec52bf58d30028807f85","ref":"","in":"body","required":false,"desc":"Notifies when a device's service property is accessed.","default":"true","type":"boolean","name":"serviceNotificationGet"},{"_id":"5ac4ec52bf58d30028807f84","ref":"","in":"body","required":false,"desc":"Notifies when a device's service property is set.","default":"true","type":"boolean","name":"serviceNotificationSet"},{"_id":"5ac4ec52bf58d30028807f83","ref":"","in":"body","required":false,"desc":"Notifies when a device's service method is called.","default":"true","type":"boolean","name":"serviceNotificationCall"},{"_id":"5ac4ec52bf58d30028807f82","ref":"","in":"body","required":false,"desc":"Notifies when a device's service property is changed.","default":"true","type":"boolean","name":"serviceNotificationChanged"},{"_id":"5ac4ec52bf58d30028807f81","ref":"","in":"body","required":false,"desc":"","default":"true","type":"boolean","name":"serviceNotificationInfo"},{"_id":"5ac4ec52bf58d30028807f80","ref":"","in":"body","required":false,"desc":"Notifies when any error is detected.","default":"true","type":"boolean","name":"serviceNotificationError"},{"_id":"5ac4ed02f07fc000460046a6","ref":"","in":"body","required":false,"desc":"Notifies when a device has been created.","default":"true","type":"boolean","name":"dataNotificationCreated"},{"_id":"5ac4ed02f07fc000460046a5","ref":"","in":"body","required":false,"desc":"Notifies when a device's data has been updated.","default":"true","type":"boolean","name":"dataNotificationUpdated"},{"_id":"5ac4ed02f07fc000460046a4","ref":"","in":"body","required":false,"desc":"Notifies when a device has been deleted.","default":"true","type":"boolean","name":"dataNotificationDeleted"}],"url":"/"},"isReference":false,"order":7,"body":"Create a webhook.\n\nAn account token or server token may be used to run this endpoint.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"WARNING\",\n  \"body\": \"All optional parameters are not supported by the SDK during creation.\"\n}\n[/block]","excerpt":"","slug":"create-a-webhook-v2","type":"endpoint","title":"Create a webhook. v2"}

postCreate a webhook. v2


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

ecosystemId:
required
string
ID of the ecosystem in which the webhook will be created
url:
required
string
The target URL of the webhook
secret:
string
Key with which hashes are generated
description:
string
Brief description of webhook
serviceNotificationsEnabled:
booleantrue
Enables selective service notifications, otherwise disables ALL service notifications (even if any specific types are enabled).
dataNotificationsEnabled:
booleanfalse
Enables selective service notifications, otherwise disables ALL data notifications (even if some specific types are enabled).
serviceNotificationEvent:
booleantrue
Notifies when any service notification is sent.
serviceNotificationGet:
booleantrue
Notifies when a device's service property is accessed.
serviceNotificationSet:
booleantrue
Notifies when a device's service property is set.
serviceNotificationCall:
booleantrue
Notifies when a device's service method is called.
serviceNotificationChanged:
booleantrue
Notifies when a device's service property is changed.
serviceNotificationInfo:
booleantrue
serviceNotificationError:
booleantrue
Notifies when any error is detected.
dataNotificationCreated:
booleantrue
Notifies when a device has been created.
dataNotificationUpdated:
booleantrue
Notifies when a device's data has been updated.
dataNotificationDeleted:
booleantrue
Notifies when a device has been deleted.

Headers

authorization:
required
string
The user's authorization token
Content-Type:
required
string
Specify that the sent data will be a JSON object

Examples


Result Format


Documentation

Create a webhook. An account token or server token may be used to run this endpoint. [block:callout] { "type": "warning", "title": "WARNING", "body": "All optional parameters are not supported by the SDK during creation." } [/block]

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}