feat: add incoming webhook docs

components/ui/CollapsibleNavItem.tsx

@@ -15,6 +15,7 @@ export type CollapsibleNavItemProps = TgphComponentProps<typeof MenuItem> & {
   className?: string;
   color?: "default" | "gray";
   isBeta?: boolean;
+  isLegacy?: boolean;
 };
 
 export const CollapsibleNavItem = ({
@@ -25,6 +26,7 @@ export const CollapsibleNavItem = ({
   color = "default",
   className = "",
   isBeta = false,
+  isLegacy = false,
   ...props
 }: CollapsibleNavItemProps) => {
   return (
@@ -52,6 +54,11 @@ export const CollapsibleNavItem = ({
               Beta
             </Tag>
           )}
+          {isLegacy && (
+            <Tag size="0" color="yellow" ml="2">
+              Legacy
+            </Tag>
+          )}
           <Icon
             icon={ChevronRight}
             size="1"

components/ui/Icons.tsx

@@ -1,5 +1,6 @@
 import {
   BookUp,
+  Cable,
   CodeXml,
   CircleHelp,
   Rows3,
@@ -14,6 +15,8 @@ import {
   Terminal,
   Landmark,
   Infinity,
+  RadioTower,
+  Rss,
   Unplug,
   Code,
   ChevronsLeftRightEllipsis,
@@ -159,7 +162,10 @@ const PascalCaseIcons = {
   Terminal,
   Landmark,
   Infinity,
+  RadioTower,
+  Rss,
   Unplug,
+  Cable,
   Code,
   ChevronsLeftRightEllipsis,
   Package,

components/ui/Page/Sidebar.tsx

@@ -177,6 +177,7 @@ const ItemWithSubpages = ({
       {...depthAdjustedCollapsibleNavItemProps}
       label={section.title ?? section.slug}
       isBeta={section?.isBeta}
+      isLegacy={section?.isLegacy}
       isOpen={isOpen}
       setIsOpen={setIsOpen}
     >
@@ -204,6 +205,11 @@ const ItemWithSubpages = ({
                   Beta
                 </Tag>
               )}
+              {page.isLegacy && (
+                <Tag color="yellow" ml="2" size="0">
+                  Legacy
+                </Tag>
+              )}
             </NavItem>
           </Box>
         );
@@ -247,6 +253,11 @@ const Item = ({ section, preSlug = "", depth = 0, defaultOpen }: ItemProps) => {
           Beta
         </Tag>
       )}
+      {section.isLegacy && (
+        <Tag color="yellow" ml="2" size="0">
+          Legacy
+        </Tag>
+      )}
     </NavItem>
   );
 };

content/integrations/overview.mdx

@@ -11,19 +11,19 @@ Section: Integrations
     title="Channels"
     description="Send messages across multiple channels like email, SMS, push, and chat apps."
     href="/integrations/overview#supported-integration-providers"
-    icon={"Unplug"}
+    icon={"Rss"}
   />
   <ContentCard
     title="Sources"
-    description="Connect your customer data platforms to Knock to receive events and trigger workflows."
+    description="Receive events from external services via webhooks, CDPs, and reverse ETL integrations."
     href="/integrations/overview#source-integrations"
-    icon={"Code"}
+    icon={"RadioTower"}
   />
   <ContentCard
     title="Extensions"
     description="Integrate Knock with other tools for debugging, monitoring, and more."
     href="/integrations/overview#platform-extensions"
-    icon={"ChevronsLeftRightEllipsis"}
+    icon={"Unplug"}
   />
 </ResponsiveThreeColumn>
 
@@ -44,16 +44,15 @@ We support the following channel types today:
 
 ## Source integrations
 
-We support receiving events from customer data platforms which can be configured to trigger notification workflows and populate [Audiences](/concepts/audiences) in Knock.
+Sources connect external services to Knock so that events from those services can trigger workflows, identify users, and manage objects and tenants. Knock supports three categories of source integrations:
+
+- **Incoming webhooks.** Receive events from services like [Stripe](/integrations/sources/stripe), [Clerk](/integrations/sources/clerk), [WorkOS](/integrations/sources/workos), [PostHog](/integrations/sources/posthog), and [Supabase](/integrations/sources/supabase), or create a [custom source](/integrations/sources/custom) for any webhook provider.
+
+- **CDP integrations.** Forward `track` and `identify` events from platforms like [Segment](/integrations/sources/segment), [RudderStack](/integrations/sources/rudderstack), [Freshpaint](/integrations/sources/freshpaint), and [Jitsu](/integrations/sources/jitsu).
+
+- **Reverse ETL integrations.** Sync warehouse data from platforms like [Hightouch](/integrations/sources/hightouch), [Census](/integrations/sources/census), and [Polytomic](/integrations/sources/polytomic).
 
-- [Segment](/integrations/sources/segment)
-- [RudderStack](/integrations/sources/rudderstack)
-- [Jitsu](/integrations/sources/jitsu)
-- [Freshpaint](/integrations/sources/freshpaint)
-- [Hightouch](/integrations/sources/hightouch)
-- [Census](/integrations/sources/census)
-- [Polytomic](/integrations/sources/polytomic)
-- [HTTP](/integrations/sources/http) (a generic HTTP endpoint for accepting events)
+See the [sources overview](/integrations/sources/overview) for configuration details, available actions, and debugging information.
 
 ## Platform extensions