{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/webhooks/webhooks.sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Introduction","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"introduction","__idx":0},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn how to receive real-time notifications from iClosed.io when events occur in your account."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-are-webhooks","__idx":1},"children":["What are Webhooks?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Webhooks are HTTP callbacks that notify your application when specific events occur in iClosed.io. Instead of polling our API for updates, webhooks push data to your server in real-time, making your integration more efficient and responsive."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-webhooks-work","__idx":2},"children":["How Webhooks Work"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subscribe"]}," – Register your webhook endpoint URL with iClosed.io"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Receive"]}," – Your server receives HTTP POST requests when events occur (body is a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["single JSON object"]}," per delivery)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Process"]}," – Handle the webhook payload to update your application"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Respond"]}," – Return a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2xx"]}," status code to acknowledge receipt"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-events","__idx":3},"children":["Supported Events"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["iClosed.io supports webhooks for the following events:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Category"},"children":["Category"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Events"},"children":["Events"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contact Events"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New contact created, contact updated, contact by status"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Call Events"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Call booked, call cancelled, call rescheduled"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Call Outcome Events"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Call outcome added"]}]}]}]}]}]},"headings":[{"value":"Introduction","id":"introduction","depth":1},{"value":"What are Webhooks?","id":"what-are-webhooks","depth":2},{"value":"How Webhooks Work","id":"how-webhooks-work","depth":2},{"value":"Supported Events","id":"supported-events","depth":2}],"frontmatter":{"sidebar":{"path":"./webhooks.sidebars.yaml"},"seo":{"title":"Introduction"}},"lastModified":"2026-04-13T09:44:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/webhooks/introduction","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}