From 9a19f3d1563ff8ee9171dc37eeefdd4a8b6010f7 Mon Sep 17 00:00:00 2001 From: Kelsi Anderson Date: Tue, 7 Apr 2026 09:15:09 -0700 Subject: [PATCH 1/4] feat: migrate events catalog overview to docs-v2 Adds main/docs/events/index.mdx and updates docs.json to point the Events Catalog tab to the local page instead of the external URL. Co-Authored-By: Claude Sonnet 4.6 --- main/docs/events/index.mdx | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/main/docs/events/index.mdx b/main/docs/events/index.mdx index 77477f865..0cde2a338 100644 --- a/main/docs/events/index.mdx +++ b/main/docs/events/index.mdx @@ -1,4 +1,22 @@ --- -title: "Events Catalog" -description: "Reference documentation for Auth0 event schemas delivered via Event Streams." +title: Events +description: Overview page for Events Explorer +sidebarTitle: Overview --- + +Events offer Auth0 customers an API-based method of synchronizing, correlating, or orchestrating changes that occur within Auth0 or 3rd-party identity providers (IdPs) to external apps or 3rd-party services. + +## Use cases + +Events are real-time notifications about specific actions – initially changes to a user and organizations, but eventually others – that have occurred within your Auth0 tenant. You can create event streams that listen for these events to orchestrate asynchronous changes (i.e., changes to an entity or flow that have been completed) in Auth0 and forward them to one of many destinations for external processing. Events support a variety of use cases, including: + +* Sending emails to new customers to welcome them or ask them to verify their email address. +* Monitoring user lifecycle changes so that you can update CRM (customer relationship management) or billing systems. + +## Resources + +| Read... | To learn... | +| :---- | :---- | +| [Create an Event Stream](/docs/customize/events/create-an-event-stream) | How to get started with an Event Stream. | +| [Event Testing, Observability, and Failure Recovery](/docs/customize/events/event-testing-observability-and-failure-recovery) | How to test and manage your active event streams. | +| [Events Best Practices](/docs/customize/events/events-best-practices) | Best practices for working with events. | From 81e0ed24e23fa7b301611cb452e1779a5a10d21f Mon Sep 17 00:00:00 2001 From: Kelsi Anderson Date: Tue, 7 Apr 2026 09:22:29 -0700 Subject: [PATCH 2/4] chore: apply PR review suggestions to events/index.mdx Update page title to "Events Catalog Overview", keep sidebarTitle as "Overview", and use fuller description per reviewer feedback. Co-Authored-By: Claude Sonnet 4.6 --- main/docs/events/index.mdx | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/main/docs/events/index.mdx b/main/docs/events/index.mdx index 0cde2a338..533bf219b 100644 --- a/main/docs/events/index.mdx +++ b/main/docs/events/index.mdx @@ -1,11 +1,9 @@ --- -title: Events -description: Overview page for Events Explorer +title: Events Catalog Overview +description: Events provide an API-based method of synchronizing, correlating, or orchestrating changes that occur within Auth0 or third-party identity providers to external apps or third-party services. sidebarTitle: Overview --- -Events offer Auth0 customers an API-based method of synchronizing, correlating, or orchestrating changes that occur within Auth0 or 3rd-party identity providers (IdPs) to external apps or 3rd-party services. - ## Use cases Events are real-time notifications about specific actions – initially changes to a user and organizations, but eventually others – that have occurred within your Auth0 tenant. You can create event streams that listen for these events to orchestrate asynchronous changes (i.e., changes to an entity or flow that have been completed) in Auth0 and forward them to one of many destinations for external processing. Events support a variety of use cases, including: From 502858a64510ae6458dc68bbae310fff20f1b897 Mon Sep 17 00:00:00 2001 From: Kelsi Anderson Date: Tue, 7 Apr 2026 09:42:23 -0700 Subject: [PATCH 3/4] fix: update events catalog nav config to docs/events Co-Authored-By: Claude Sonnet 4.6 --- main/docs.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/main/docs.json b/main/docs.json index f3bb283e0..9a6605a33 100644 --- a/main/docs.json +++ b/main/docs.json @@ -3745,7 +3745,7 @@ { "tab": "Events Catalog", "pages": [ - "docs/events/index", + "docs/events", { "group": " ", "pages": [ @@ -7028,7 +7028,7 @@ { "tab": "Events Catalog", "pages": [ - "docs/fr-ca/events/index", + "docs/fr-ca/events", { "group": " ", "pages": [ @@ -10311,7 +10311,7 @@ { "tab": "Events Catalog", "pages": [ - "docs/ja-jp/events/index", + "docs/ja-jp/events", { "group": " ", "pages": [ From b8be673f689c36787fd7824f4c86ded6a125cde9 Mon Sep 17 00:00:00 2001 From: Kelsi Anderson Date: Mon, 13 Apr 2026 12:10:42 -0700 Subject: [PATCH 4/4] fix: update events catalog nav config to docs/events/index for fr-ca and ja-jp Co-Authored-By: Claude Sonnet 4.6 --- main/docs.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/main/docs.json b/main/docs.json index 9a6605a33..f3bb283e0 100644 --- a/main/docs.json +++ b/main/docs.json @@ -3745,7 +3745,7 @@ { "tab": "Events Catalog", "pages": [ - "docs/events", + "docs/events/index", { "group": " ", "pages": [ @@ -7028,7 +7028,7 @@ { "tab": "Events Catalog", "pages": [ - "docs/fr-ca/events", + "docs/fr-ca/events/index", { "group": " ", "pages": [ @@ -10311,7 +10311,7 @@ { "tab": "Events Catalog", "pages": [ - "docs/ja-jp/events", + "docs/ja-jp/events/index", { "group": " ", "pages": [