custom events

docusaurus/video/docusaurus/docs/api/webhooks/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "Webhooks",
+  "label": "Events and Webhooks",
   "position": 6
 }

docusaurus/video/docusaurus/docs/api/webhooks/overview.mdx

@@ -5,6 +5,41 @@ slug: /webhooks/overview
 title: Overview
 ---
 
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+## Custom events
+
+You can send custom events to all users watching a call, events can be send client-side or server-side. It is not necessary for users to be part the call, you call objects can be "watched" before joining as well.
+Client-side you can observe calls and receive events by passing the `watch:true` parameter to any of these endpoints: `GetCall`, `QueryCalls`, `JoinCall`.
+
+<Tabs groupId="examples">
+<TabItem value="js" label="JavaScript">
+
+```js
+// send a custom event to all users watching the call
+TODO
+```
+
+</TabItem>
+<TabItem value="py" label="Python">
+
+```py
+# send a custom event to all users watching the call
+call.send_call_event(user_id=user.id, custom={"render-animation": "balloons"})
+```
+
+</TabItem>
+<TabItem value="curl" label="cURL">
+
+```bash
+TODO
+```
+
+</TabItem>
+</Tabs>
+
+
 You can configure your Stream app to send events to your HTTP/webhook and/or to your AWS SQS queue. Webhooks are usually
 the simplest way to receive events from your app and to perform additional action based on what happens to your application.