{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/v1/webhooks","auth":"required","settings":"","examples":{"codes":[{"language":"text","code":"curl 'https://www.sendsonar.com/api/v1/webhooks' \\\n -X POST \\\n -H 'X-Token:YOUR_TOKEN' \\\n -H \"Content-Type: application/json\" \\\n -d '{\"webhook\": {\"name\": \"Cat\", \"active\": \"true\", \"settings\": {}, \"url\": \"http://meow.meow\", \"http_method\": \"POST\"}}'"}]},"method":"post","params":[{"name":"active","type":"boolean","default":"false","desc":"Set the webhook as active or inactive","required":false,"in":"body","ref":"","_id":"5696f91c59a6692d003fad55"},{"name":"settings","type":"array_object","default":"","desc":"When to trigger the webhook (see below)","required":false,"in":"body","ref":"","_id":"5696f91c59a6692d003fad54"},{"name":"url","type":"string","default":"","desc":"The endpoint the webhook should hit","required":false,"in":"body","ref":"","_id":"5696f91c59a6692d003fad53"},{"name":"http_method","type":"string","default":"","desc":"The http method the webhook should use","required":false,"in":"body","ref":"","_id":"5696f91c59a6692d003fad52"},{"name":"name","type":"string","default":"","desc":"Name of the webhook","required":false,"in":"body","ref":"","_id":"5696f91c59a6692d003fad51"}],"results":{"codes":[{"status":200,"language":"json","code":"{\"id\":2,\"active\":true,\"settings\":{\"new_assigned_message\":\"true\",\"new_unassigned_message\":\"true\"},\"url\":\"https://kittenland.com\",\"http_method\":\"POST\",\"payload\":\"\",\"name\":\"Meow Webhook1\",\"created_at\":\"2015-07-25T20:19:09.213-07:00\",\"updated_at\":\"2015-08-08T16:46:20.364-07:00\"}","name":""}]}},"next":{"description":"","pages":[]},"title":"Create Webhook","type":"endpoint","slug":"create-webhook","excerpt":"","body":"## **Settings Description** \n[block:parameters]\n{\n \"data\": {\n \"0-0\": \"new_assigned_message\",\n \"0-1\": \"true/false\",\n \"0-2\": \"Triggers webhook when a message comes from an assigned customer\",\n \"h-0\": \"Setting\",\n \"h-1\": \"Values\",\n \"h-2\": \"Description\",\n \"1-0\": \"new_unassigned_message\",\n \"2-0\": \"customer_subscribed\",\n \"3-0\": \"customer_unsubscribed\",\n \"4-0\": \"outbound_message\",\n \"1-1\": \"true/false\",\n \"2-1\": \"true/false\",\n \"3-1\": \"true/false\",\n \"4-1\": \"true/false\",\n \"1-2\": \"Triggers webhook when a message comes from an unassigned customer\",\n \"2-2\": \"Triggers webhook when a customer gets subscribed\",\n \"3-2\": \"Triggers webhook when a customer gets unsubscribed\",\n \"4-2\": \"Triggers webhook when a user sends a message to a customer\"\n },\n \"cols\": 3,\n \"rows\": 5\n}\n[/block]\nExample of data that will be passed from a triggered webhook:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"JSON {\\n action: 'new_assigned_message', \\n text: 'Hey, can you help me with something on your site?', \\n from_name: 'Sonar Customer', \\n to_name: 'Your_Companys User', \\n link: 'https://sendsonar.com/threads/homer_simpsons_thread', \\n customer { \\n first_name: 'Sonar', \\n last_name: 'Customer', \\n phone_number: '+12345678910' \\n } \\n user { \\n first_name: 'Your_Companys', \\n last_name: 'User', \\n email: 'service_rep:::at:::company.com' \\n } \\n} \",\n \"language\": \"json\"\n }\n ]\n}\n[/block]\nAll customers are subscribed by default. If you unsubscribe a customer, that customer won't get any messages until you subscribe this customer back.","updates":[],"order":29,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5696f91c59a6692d003fad50","editedParams":true,"user":"55208129504fd6230022ae20","version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":true,"is_hidden":false,"is_deprecated":false,"categories":["55208138623ff50d009b2bf0","55494a226a82a10d00817ae5","55494ba7ee219b0d001743c8","55494bc1ee219b0d001743cc","56ead8c1df765617008bccaf","573a2073dd007d1700cf288f","579695b1f64c9f0e007cd76c","57969e3dfa1ff60e006a1274","579a4592fd9f3c0e008e4f4a","57ab9afe54fa780e006c5430","57b784f5b7ebd60e009cb4a6","58f686818193090f008cec76","59e79fbd4cf31900341d50c6","5b2436973fd93f0003dcf99d","5d824fb2ce98a801366098a2","61096ffb8de715001695ae54"],"_id":"55208137623ff50d009b2bef","createdAt":"2015-04-05T00:26:31.564Z","releaseDate":"2015-04-05T00:26:31.563Z","__v":16,"project":"55208137623ff50d009b2bec"},"__v":2,"category":{"sync":{"isSync":false,"url":""},"pages":["55494ad0ee219b0d001743bb","55494b05f452670d00ec0c29","55494b11ee219b0d001743bf","55494b20ee219b0d001743c1","55494b2bee219b0d001743c3","55494b4a6a82a10d00817af5","55494b686a82a10d00817af9","5549651ccd09b317005f8f50","55497273cd09b317005f8f86","554977f0c634cf2d001250a7","55b970eab42b610d00c9b2e3","5696f3688560a60d00e2c216","5696f91c59a6692d003fad50","5696f92c24490c3700170a2d","5696f9700b09a41900b24422"],"title":"Public API","slug":"public-api","order":3,"from_sync":false,"reference":true,"_id":"55494a226a82a10d00817ae5","createdAt":"2015-05-05T22:54:26.925Z","project":"55208137623ff50d009b2bec","version":"55208137623ff50d009b2bef","__v":15},"createdAt":"2016-01-14T01:25:48.046Z","editedParams2":true,"githubsync":"","parentDoc":null,"project":"55208137623ff50d009b2bec"}
postCreate Webhook
Definition
{{ api_url }}{{ page_api_url }}
Parameters
Body Params
active:
booleanfalse
Set the webhook as active or inactive
settings:
array of objects
When to trigger the webhook (see below)
url:
string
The endpoint the webhook should hit
http_method:
string
The http method the webhook should use
name:
string
Name of the webhook