docs: add broadcast.start and broadcast.end events to X Activity API

Author: mintlify[bot]

x-api/activity/event-payloads.mdx

@@ -2044,6 +2044,120 @@ Fired when the filtered user unblocks another user.
 
 ## Broadcast events
 
+### `broadcast.start`
+
+Fired when a user starts a live broadcast. Public event — can be subscribed to with either app-only or user-context authentication. The `payload` includes the host `user` and the `broadcast_id`.
+
+```json title="broadcast.start" expandable lines wrap icon="/icons/xds/icon-brackets.svg"
+{
+  "data": {
+    "event_uuid": "4093201169289922042",
+    "filter": {
+      "user_id": "1111111111111111111"
+    },
+    "event_type": "broadcast.start",
+    "tag": "broadcast-start",
+    "payload": {
+      "user": {
+        "data": {
+          "affiliation": {
+            "description": "X",
+            "badge_url": "https://pbs.twimg.com/profile_images/0000000000000000001/example_normal.jpg",
+            "url": "https://twitter.com/X"
+          },
+          "location": "San Francisco, CA",
+          "name": "Example User",
+          "profile_image_url": "https://pbs.twimg.com/profile_images/0000000000000000001/example_normal.jpg",
+          "created_at": "2023-10-23T13:44:53.000Z",
+          "protected": false,
+          "verified": true,
+          "url": "https://t.co/xxxxxxxx",
+          "public_metrics": {
+            "followers_count": 5502,
+            "followers_count_str": "5502",
+            "following_count": 651,
+            "following_count_str": "651",
+            "tweet_count": 789,
+            "tweet_count_str": "789",
+            "listed_count": 46,
+            "listed_count_str": "46",
+            "like_count": 8010,
+            "like_count_str": "8010",
+            "media_count": 79,
+            "media_count_str": "79"
+          },
+          "is_identity_verified": true,
+          "description": "Building with the X AnotherUser @XDevelopers",
+          "verified_type": "blue",
+          "profile_banner_url": "https://pbs.twimg.com/profile_banners/1111111111111111111/1600000000",
+          "username": "ExampleUser",
+          "id": "1111111111111111111"
+        }
+      },
+      "broadcast_id": "1mGPaZaAdNqJN",
+      "event_type": "broadcast_start"
+    }
+  }
+}
+```
+
+### `broadcast.end`
+
+Fired when a user ends a live broadcast. Public event — can be subscribed to with either app-only or user-context authentication. Same shape as `broadcast.start` with an inner `event_type` of `broadcast_end`.
+
+```json title="broadcast.end" expandable lines wrap icon="/icons/xds/icon-brackets.svg"
+{
+  "data": {
+    "event_uuid": "-498317022904955632",
+    "filter": {
+      "user_id": "1111111111111111111"
+    },
+    "event_type": "broadcast.end",
+    "tag": "broadcast-end",
+    "payload": {
+      "user": {
+        "data": {
+          "affiliation": {
+            "description": "X",
+            "badge_url": "https://pbs.twimg.com/profile_images/0000000000000000001/example_normal.jpg",
+            "url": "https://twitter.com/X"
+          },
+          "location": "San Francisco, CA",
+          "name": "Example User",
+          "profile_image_url": "https://pbs.twimg.com/profile_images/0000000000000000001/example_normal.jpg",
+          "created_at": "2023-10-23T13:44:53.000Z",
+          "protected": false,
+          "verified": true,
+          "url": "https://t.co/xxxxxxxx",
+          "public_metrics": {
+            "followers_count": 5502,
+            "followers_count_str": "5502",
+            "following_count": 651,
+            "following_count_str": "651",
+            "tweet_count": 789,
+            "tweet_count_str": "789",
+            "listed_count": 46,
+            "listed_count_str": "46",
+            "like_count": 8010,
+            "like_count_str": "8010",
+            "media_count": 79,
+            "media_count_str": "79"
+          },
+          "is_identity_verified": true,
+          "description": "Building with the X AnotherUser @XDevelopers",
+          "verified_type": "blue",
+          "profile_banner_url": "https://pbs.twimg.com/profile_banners/1111111111111111111/1600000000",
+          "username": "ExampleUser",
+          "id": "1111111111111111111"
+        }
+      },
+      "broadcast_id": "1mGPaZaAdNqJN",
+      "event_type": "broadcast_end"
+    }
+  }
+}
+```
+
 ### `broadcast.chat`
 
 Fired when the filtered user receives a chat message in a broadcast that they own. Private event — requires user-context authentication with the `broadcast.read` scope. The `payload` includes the `broadcast_id`, the chat `message_id` and `message` text, and an `author` block with the sending user's profile.

x-api/activity/introduction.mdx

@@ -162,13 +162,17 @@ Block events are triggered when the filtered user blocks or unblocks another use
 
 ### Broadcast events
 
-Broadcast events are triggered when the filtered user receives a chat message in a broadcast that they own.
+Broadcast events are triggered when the filtered user starts or ends a live broadcast, or receives a chat message in a broadcast that they own.
 
-| Event Name       | Description                                                                            | Filters   |
-| ---------------- | -------------------------------------------------------------------------------------- | --------- |
-| `broadcast.chat` | Fired when the filtered user receives a chat message in a broadcast that they own      | `user_id` |
+| Event Name        | Description                                                                            | Filters   |
+| ----------------- | -------------------------------------------------------------------------------------- | --------- |
+| `broadcast.start` | Fired when a user starts a live broadcast                                              | `user_id` |
+| `broadcast.end`   | Fired when a user ends a live broadcast                                                | `user_id` |
+| `broadcast.chat`  | Fired when the filtered user receives a chat message in a broadcast that they own      | `user_id` |
 
 <Note>
+  **Public events:** `broadcast.start` and `broadcast.end` are public events and can be subscribed to with either app-only or user-context authentication.
+
   **Private event:** `broadcast.chat` is a private event and requires user-context (OAuth 2.0) authentication with the `broadcast.read` scope. See [Event privacy and authentication](#event-privacy-and-authentication) below.
 </Note>
 
@@ -193,6 +197,7 @@ Public events are activities that a public user account performs publicly that a
 **Current public events:**
 - Profile updates (bio, picture, banner, location, URL, username changes)
 - Post creation (`post.create`) and deletion (`post.delete`)
+- Broadcast start (`broadcast.start`) and end (`broadcast.end`)
 
 For these public events, you can create subscriptions by specifying the user ID in your filter and receive them via XAA.