:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
feat(workflows): give transactional emails their own section (#123978)
Meikel Ratz06ea47b450f5
diff --git a/frontend/snapshots.yml b/frontend/snapshots.ymlindex 4f3108d7213d..05c7d89b80ff 100644--- a/frontend/snapshots.yml+++ b/frontend/snapshots.yml@@ -4447,9 +4447,9 @@ snapshots:layout-products-and-files--customize-sidebar-ranked--light:hash: v1.k794b7964.c1c2175898388b295a8941c1db37d1e2257da42ff81028c1aba622e9e177f024.BiJ4KBPu1QmZw9oaeH2duOwRSdOVDWzeenW1O7xxH54layout-products-and-files--customize-sidebar-save-failure--dark:- hash: v1.k794b7964.9af1aba9e2be1e99320fa4220a2d2e25826e106f1021fa88bc8718d039d0f049.7QDFJSL11xqPkC593iwnaVzIJta2SzlWApSpGG2fNYg+ hash: v1.k794b7964.dcdc4a510b507e025b163661f7c9073f4337a6d41100e9e7a100f5cec8d34ed3.g-5GCUIOrgJTlPdl--lK0pEi9qL-LcwqXbbz6_w_WKUlayout-products-and-files--customize-sidebar-save-failure--light:- hash: v1.k794b7964.5b597969c1bdddac573a471156fac566162b2e4323b62872e687e6dd1536c087.uFw2D1TupXhFlwf85N42ddhWKpmWXlUpTatq0rNHeug+ hash: v1.k794b7964.3136e445b56499302702d21df93dc07d8dc1419869a14a8043f5372f57acec98.6Jahl0W7vAjb00GWB49WUk5E4eKRDbB7L5lCsQez-x8layout-products-and-files--customize-sidebar-unavailable--dark:hash: v1.k794b7964.6e3eefbb325baa7677d1e5eed93186c76c6f0708a5de418155ec13871fe9f89a.A-wuvvKQe8M5_hUPQ5EuFIwiKi4jpv8mOuy0V_Fb6mclayout-products-and-files--customize-sidebar-unavailable--light:diff --git a/frontend/src/layout/panel-layout/ProjectTree/defaultTree.tsx b/frontend/src/layout/panel-layout/ProjectTree/defaultTree.tsxindex 9b80526fbc0c..8de132531330 100644--- a/frontend/src/layout/panel-layout/ProjectTree/defaultTree.tsx+++ b/frontend/src/layout/panel-layout/ProjectTree/defaultTree.tsx@@ -37,6 +37,7 @@ import {IconList,IconListCheck,IconListTree,+ IconLetter,IconLive,IconLlmAnalytics,IconLlmPromptManagement,@@ -255,6 +256,10 @@ const iconTypes: Record<FileSystemIconType, { icon: JSX.Element; iconColor?: Filicon: <IconSend />,iconColor: ['var(--color-product-broadcasts-light)', 'var(--color-product-broadcasts-dark)'],},+ transactional: {+ icon: <IconLetter />,+ iconColor: ['var(--color-product-workflows-light)', 'var(--color-product-workflows-dark)'],+ },notebook: {icon: <IconNotebook />,iconColor: ['var(--color-product-notebooks-light)', 'var(--color-product-notebooks-dark)'],diff --git a/frontend/src/layout/panel-layout/sidebarProductMeta.ts b/frontend/src/layout/panel-layout/sidebarProductMeta.tsindex b479df91c4c9..0852fa29106b 100644--- a/frontend/src/layout/panel-layout/sidebarProductMeta.ts+++ b/frontend/src/layout/panel-layout/sidebarProductMeta.ts@@ -76,6 +76,7 @@ export const SIDEBAR_PRODUCTS_WITHOUT_DOCS = new Set<string>(['Identity matching','Product tours','Pulse',+ 'Transactional','Uptime monitoring','Visual review',])@@ -99,6 +100,7 @@ const examples: Record<string, string> = {Cohorts: 'Compare people who tried a feature with those who have not.',Apps: 'Build an internal Python dashboard using your project data.',Broadcasts: 'Send an announcement to a cohort of beta testers.',+ Transactional: 'Send a password reset email from your backend.','Business knowledge': 'Give your AI assistant context about how your business works.',Clusters: 'Discover common themes in conversations with your AI assistant.','Code review': 'Review automated findings on a pull request before it merges.',diff --git a/frontend/src/productScenes.tsx b/frontend/src/productScenes.tsxindex 49d5139eff3d..104396720761 100644--- a/frontend/src/productScenes.tsx+++ b/frontend/src/productScenes.tsx@@ -216,5 +216,6 @@ export const productScenes: Record<string, () => Promise<any>> = {WorkflowsLibraryTemplate: () => import('../../products/workflows/frontend/TemplateLibrary/MessageTemplate'),Broadcasts: () => import('../../products/workflows/frontend/Broadcasts/BroadcastsScene'),Broadcast: () => import('../../products/workflows/frontend/Broadcasts/BroadcastScene'),+ Transactional: () => import('../../products/workflows/frontend/Transactional/TransactionalScene'),WorkflowsEmailDomain: () => import('../../products/workflows/frontend/Channels/EmailDomain/EmailDomainScene'),}diff --git a/frontend/src/products.json b/frontend/src/products.jsonindex f0e80a505b04..0ac984a1b6d7 100644--- a/frontend/src/products.json+++ b/frontend/src/products.json@@ -289,6 +289,13 @@"iconType": "broadcasts","type": "broadcasts","intents": ["workflows"]+ },+ {+ "path": "Transactional",+ "category": "Messaging",+ "iconType": "transactional",+ "type": "transactional",+ "intents": ["workflows"]}],"games": [diff --git a/frontend/src/products.tsx b/frontend/src/products.tsxindex b2fef6880b94..da0cac69bca6 100644--- a/frontend/src/products.tsx+++ b/frontend/src/products.tsx@@ -386,6 +386,15 @@ export const productRoutes: Record<string, [string, string]> = {'/broadcasts/reputation': ['Broadcasts', 'broadcasts'],'/broadcasts/settings': ['Broadcasts', 'broadcasts'],'/broadcasts/calendar': ['Broadcasts', 'broadcasts'],+ '/transactional': ['Transactional', 'transactional'],+ '/transactional/library': ['Transactional', 'transactional'],+ '/transactional/channels': ['Transactional', 'transactional'],+ '/transactional/opt-outs': ['Transactional', 'transactional'],+ '/transactional/suppression': ['Transactional', 'transactional'],+ '/transactional/reputation': ['Transactional', 'transactional'],+ '/transactional/settings': ['Transactional', 'transactional'],+ '/transactional/library/templates/:id': ['WorkflowsLibraryTemplate', 'workflowsLibraryTemplate'],+ '/broadcasts/library/templates/:id': ['WorkflowsLibraryTemplate', 'workflowsLibraryTemplate'],'/broadcasts/new': ['Broadcast', 'broadcast'],'/broadcasts/:id': ['Broadcast', 'broadcast'],}@@ -1331,6 +1340,12 @@ export const productConfiguration: Record<string, any> = {projectBased: true,description: 'Send a one-time or scheduled email to a group of people',},+ Transactional: {+ name: 'Transactional',+ iconType: 'transactional',+ projectBased: true,+ description: 'Send emails from your code with one API call',+ },WorkflowsEmailDomain: { name: 'Workflows', iconType: 'workflows', projectBased: true },}@@ -2015,6 +2030,9 @@ export const productUrls = {broadcasts: (tab?: MessagingNavTabKey | 'calendar'): string => `/broadcasts${tab ? `/${tab}` : ''}`,broadcast: (id: string): string => `/broadcasts/${id}`,broadcastNew: (): string => '/broadcasts/new',+ transactional: (tab?: MessagingNavTabKey): string => `/transactional${tab ? `/${tab}` : ''}`,+ transactionalTemplate: (id: string): string => `/transactional/library/templates/${id}`,+ broadcastsTemplate: (id: string): string => `/broadcasts/library/templates/${id}`,}/** This const is auto-generated, as is the whole file */@@ -2392,6 +2410,7 @@ export type ProductTreePath =| 'Tasks'| 'Toolbar'| 'Tracing'+ | 'Transactional'| 'Uptime monitoring'| 'Visual review'| 'Web analytics'@@ -2452,6 +2471,7 @@ export const getTreeItemsProducts = (): FileSystemImport[] => ['WorkflowsLibraryTemplate','Broadcasts','Broadcast',+ 'Transactional','WorkflowsEmailDomain',],},@@ -3298,6 +3318,26 @@ export const getTreeItemsProducts = (): FileSystemImport[] => [sceneKey: 'Tracing',sceneKeys: ['Tracing', 'TracingOperation', 'TracingRetentionNew', 'TracingRetentionDetail'],},+ {+ path: 'Transactional',+ intents: [ProductKey.WORKFLOWS],+ href: urls.transactional(),+ type: 'transactional',+ category: ProductItemCategory.MESSAGING,+ iconType: 'transactional',+ iconColor: ['var(--color-product-workflows-light)', 'var(--color-product-workflows-dark)'],+ sceneKey: 'Transactional',+ flag: FEATURE_FLAGS.WORKFLOWS_TRANSACTIONAL_EMAIL_API,+ sceneKeys: [+ 'Workflows',+ 'Workflow',+ 'WorkflowsLibraryTemplate',+ 'Broadcasts',+ 'Broadcast',+ 'Transactional',+ 'WorkflowsEmailDomain',+ ],+ },{path: 'Uptime monitoring',intents: [ProductKey.UPTIME_MONITORING],@@ -3393,6 +3433,7 @@ export const getTreeItemsProducts = (): FileSystemImport[] => ['WorkflowsLibraryTemplate','Broadcasts','Broadcast',+ 'Transactional','WorkflowsEmailDomain',],},diff --git a/frontend/src/queries/schema.json b/frontend/src/queries/schema.jsonindex 3657a3f819b4..4e41446d58c4 100644--- a/frontend/src/queries/schema.json+++ b/frontend/src/queries/schema.json@@ -27638,6 +27638,7 @@"uptime_monitoring","workflows","broadcasts",+ "transactional","notebook","action","activity",diff --git a/frontend/src/queries/schema/schema-general.ts b/frontend/src/queries/schema/schema-general.tsindex 5cdfc22d3309..47f9e9fc2dec 100644--- a/frontend/src/queries/schema/schema-general.ts+++ b/frontend/src/queries/schema/schema-general.ts@@ -5684,6 +5684,7 @@ export type FileSystemIconType =| 'uptime_monitoring'| 'workflows'| 'broadcasts'+ | 'transactional'| 'notebook'| 'action'| 'activity'diff --git a/frontend/src/scenes/sceneTypes.ts b/frontend/src/scenes/sceneTypes.tsindex 45b0ec54f584..90ca58708fbf 100644--- a/frontend/src/scenes/sceneTypes.ts+++ b/frontend/src/scenes/sceneTypes.ts@@ -221,6 +221,7 @@ export enum Scene {Endpoint = 'Endpoint',Workflow = 'Workflow',Broadcasts = 'Broadcasts',+ Transactional = 'Transactional',Workflows = 'Workflows',Broadcast = 'Broadcast',WorkflowsEmailDomain = 'WorkflowsEmailDomain',@@ -456,6 +457,7 @@ export const sceneToAccessControlResourceType: Partial<// Workflows[Scene.Workflow]: AccessControlResourceType.Workflow,[Scene.Broadcasts]: AccessControlResourceType.Workflow,+ [Scene.Transactional]: AccessControlResourceType.Workflow,[Scene.Workflows]: AccessControlResourceType.Workflow,[Scene.Broadcast]: AccessControlResourceType.Workflow,[Scene.WorkflowsEmailDomain]: AccessControlResourceType.Workflow,diff --git a/posthog/schema_enums.py b/posthog/schema_enums.pyindex 72989bafcff8..73761220cf99 100644--- a/posthog/schema_enums.py+++ b/posthog/schema_enums.py@@ -1578,6 +1578,7 @@ class FileSystemIconType(StrEnum):UPTIME_MONITORING = "uptime_monitoring"WORKFLOWS = "workflows"BROADCASTS = "broadcasts"+ TRANSACTIONAL = "transactional"NOTEBOOK = "notebook"ACTION = "action"ACTIVITY = "activity"diff --git a/products/workflows/frontend/TemplateLibrary/MessageTemplate.tsx b/products/workflows/frontend/TemplateLibrary/MessageTemplate.tsxindex eb782423f30a..6b03be375af9 100644--- a/products/workflows/frontend/TemplateLibrary/MessageTemplate.tsx+++ b/products/workflows/frontend/TemplateLibrary/MessageTemplate.tsx@@ -90,6 +90,7 @@ export function MessageTemplate(props: MessageTemplateSceneLogicProps): JSX.ElemisSavingDraft,isDiscardingDraft,isSavingSensitive,+ createAsTransactional,} = useValues(logic)const transactionalEmailsEnabled = useFeatureFlag('WORKFLOWS_TRANSACTIONAL_EMAIL_API')const todayRailNav = useFeatureFlag('TODAY_RAIL_NAV')@@ -137,7 +138,7 @@ export function MessageTemplate(props: MessageTemplateSceneLogicProps): JSX.ElemonChange={(value) => setTemplateValue('content.email', value)}onChangeTemplating={(templating) => setTemplateValue('content.email.templating', templating)}type={- template?.transactional_hog_flow_id+ template?.transactional_hog_flow_id || createAsTransactional? 'native_email_transactional_template': 'native_email_template'}@@ -260,6 +261,12 @@ export function MessageTemplate(props: MessageTemplateSceneLogicProps): JSX.Elem</Tooltip>)}</>+ ) : createAsTransactional ? (+ <Tooltip title="Saving creates the email and makes it transactional, so you can send it from your code.">+ <LemonTag type="success" className="ml-1">+ Transactional+ </LemonTag>+ </Tooltip>) : undefined}actions={diff --git a/products/workflows/frontend/TemplateLibrary/MessageTemplatesTable.tsx b/products/workflows/frontend/TemplateLibrary/MessageTemplatesTable.tsxindex d042857c11d6..a006244d68b1 100644--- a/products/workflows/frontend/TemplateLibrary/MessageTemplatesTable.tsx+++ b/products/workflows/frontend/TemplateLibrary/MessageTemplatesTable.tsx@@ -22,13 +22,13 @@ import { lemonToast } from 'lib/lemon-ui/LemonToast'import { Spinner } from 'lib/lemon-ui/Spinner'import { getAccessControlDisabledReason } from 'lib/utils/accessControlUtils'import MaxTool from 'scenes/max/MaxTool'-import { urls } from 'scenes/urls'import { AccessControlLevel, AccessControlResourceType } from '~/types'import { MessageTemplateCard } from './MessageTemplateCard'import { messageTemplatesLogic, saveTemplateTags } from './messageTemplatesLogic'import { newTemplateAgentLogic } from './newTemplateAgentLogic'+import { templateSectionFor, templateUrlInSection } from './templateSection'const HedgehogReadingIsMagic = pngHoggie(readingIsMagicPng)@@ -148,7 +148,14 @@ export function MessageTemplatesTable(): JSX.Element {key={template.id}template={template}index={index}- onClick={() => router.actions.push(urls.workflowsLibraryTemplate(template.id))}+ onClick={() =>+ router.actions.push(+ templateUrlInSection(+ template.id,+ templateSectionFor(router.values.location.pathname)+ )+ )+ }onTagClick={(tag) => !tagsFilter.includes(tag) && setTagsFilter([...tagsFilter, tag])}actions={<Morediff --git a/products/workflows/frontend/TemplateLibrary/messageTemplateLogic.test.ts b/products/workflows/frontend/TemplateLibrary/messageTemplateLogic.test.tsindex 979b3d0caab5..ae2e0a4c6a97 100644--- a/products/workflows/frontend/TemplateLibrary/messageTemplateLogic.test.ts+++ b/products/workflows/frontend/TemplateLibrary/messageTemplateLogic.test.ts@@ -3,6 +3,7 @@ import { expectLogic } from 'kea-test-utils'import { FEATURE_FLAGS } from 'lib/constants'import { featureFlagLogic } from 'lib/logic/featureFlagLogic'+import { removeProjectIdIfPresent } from 'lib/utils/kea-router'import { useMocks } from '~/mocks/jest'import { initKeaTests } from '~/test/init'@@ -10,6 +11,7 @@ import type { ResourceEditedEvent } from '~/types'import { resourceEditedLogic } from 'products/notifications/frontend/resourceEditedLogic'+import { NEW_TEMPLATE } from './constants'import { messageTemplateLogic } from './messageTemplateLogic'jest.mock('lib/lemon-ui/LemonToast', () => ({@@ -463,5 +465,28 @@ describe('messageTemplateLogic', () => {expect(logic.values.template.name).toEqual('Renamed while converting')}})++ test.each([+ ['from the Transactional section converts it and opens it', { transactional: 'true' }, 1, '/created-id'],+ ['as a plain template leaves it alone', {}, 0, '/workflows/library'],+ ])('first save of a new template started %s', async (_name, search, expectedConversions, expectedPath) => {+ const makeTransactional = jest.fn(() => [200, { id: 'created-id', transactional_hog_flow_id: 'flow-id' }])+ useMocks({+ post: {+ '/api/projects/:team_id/messaging_templates/': { ...NEW_TEMPLATE, id: 'created-id' },+ '/api/projects/:team_id/messaging_templates/:id/make_transactional/': makeTransactional,+ },+ })+ router.actions.push('/workflows/library/templates/new', search)+ logic = messageTemplateLogic({ id: 'new' })+ logic.mount()++ await expectLogic(logic, () => {+ logic.actions.saveTemplate(logic.values.template)+ }).toFinishAllListeners()++ expect(makeTransactional).toHaveBeenCalledTimes(expectedConversions)+ expect(removeProjectIdIfPresent(router.values.location.pathname)).toMatch(new RegExp(`${expectedPath}$`))+ })})})diff --git a/products/workflows/frontend/TemplateLibrary/messageTemplateLogic.ts b/products/workflows/frontend/TemplateLibrary/messageTemplateLogic.tsindex 1814ae4caa05..089fde78f8ba 100644--- a/products/workflows/frontend/TemplateLibrary/messageTemplateLogic.ts+++ b/products/workflows/frontend/TemplateLibrary/messageTemplateLogic.ts@@ -34,7 +34,8 @@ import type { HogFunctionType, ResourceEditedEvent, UserBasicType } from '../../import type { IntegrationType } from '../../../../frontend/src/types'import { workflowLogic } from '../Workflows/workflowLogic'import { NEW_TEMPLATE } from './constants'-import { newTemplateAgentLogic } from './newTemplateAgentLogic'+import { TRANSACTIONAL_PARAM, newTemplateAgentLogic } from './newTemplateAgentLogic'+import { TemplateSection, templateLibraryUrl, templateSectionFor, templateUrlInSection } from './templateSection'import { MessageTemplate } from './types'export type TransactionalTemplateTab = 'design' | 'metrics' | 'sends' | 'versions' | 'api'@@ -62,6 +63,7 @@ export interface messageTemplateLogicValues {integrations: IntegrationType[] | null // integrationsLogicaiComposerAvailable: boolean // newTemplateAgentLogiccurrentTeamIdStrict: number | string // teamLogic+ createAsTransactional: booleandeferredExternalEdit: ResourceEditedEvent | nulldraftOutOfDate: booleandraftsEnabled: boolean@@ -75,12 +77,15 @@ export interface messageTemplateLogicValues {isSyncingExternalEdit: booleanisTemplateSubmitting: booleanisTemplateValid: boolean+ isTransactional: boolean+ listUrl: stringlogicProps: MessageTemplateLogicPropsmessage: anymessageLoading: booleanoriginalTemplate: MessageTemplatepublishedContent: TemplateContent | nullsavedDraft: TemplateContent | null+ section: TemplateSectionshowTemplateErrors: booleantemplate: MessageTemplatetemplateAllErrors: Record<string, any>@@ -442,7 +447,11 @@ export interface messageTemplateLogicMeta {key: string__keaTypeGenInternalSelectorTypes: {logicProps: (arg: MessageTemplateLogicProps) => MessageTemplateLogicProps+ createAsTransactional: (searchParams: Record<string, any>, arg: MessageTemplateLogicProps) => booleantransactionalHogFlowId: (originalTemplate: MessageTemplate) => string | null+ isTransactional: (transactionalHogFlowId: string | null, createAsTransactional: boolean) => boolean+ section: (location: { hash: string; pathname: string; search: string }) => TemplateSection+ listUrl: (isTransactional: boolean, section: TemplateSection) => stringdraftsEnabled: (transactionalHogFlowId: string | null) => booleanhasDraft: (savedDraft: {@@ -648,11 +657,33 @@ export const messageTemplateLogic = kea<messageTemplateLogicType>([],}),selectors({+ // A new template started from the Transactional section. Its first save also makes it transactional.+ createAsTransactional: [+ () => [router.selectors.searchParams, (_, props: MessageTemplateLogicProps) => props],+ (searchParams: Record<string, any>, props: MessageTemplateLogicProps): boolean =>+ props.id === 'new' && !props.messageId && searchParams[TRANSACTIONAL_PARAM] === 'true',+ ],// The saved state decides it: an unsaved template can't be transactional yet.transactionalHogFlowId: [(s) => [s.originalTemplate],(originalTemplate: MessageTemplate): string | null => originalTemplate.transactional_hog_flow_id ?? null,],+ isTransactional: [+ (s) => [s.transactionalHogFlowId, s.createAsTransactional],+ (transactionalHogFlowId: string | null, createAsTransactional: boolean): boolean =>+ !!transactionalHogFlowId || createAsTransactional,+ ],+ // The nav section the page was opened under. Links from the page stay in it.+ section: [+ () => [router.selectors.location],+ (location: { pathname: string }): TemplateSection => templateSectionFor(location.pathname),+ ],+ // The list a person returns to: transactional emails live in their own section.+ listUrl: [+ (s) => [s.isTransactional, s.section],+ (isTransactional: boolean, section: TemplateSection): string =>+ isTransactional ? urls.transactional() : templateLibraryUrl(section),+ ],// Sends use a transactional template's content, so its edits save as a draft until they are published.draftsEnabled: [(s) => [s.transactionalHogFlowId],@@ -982,6 +1013,21 @@ export const messageTemplateLogic = kea<messageTemplateLogicType>([lemonToast.error('Failed to save template. Please try again.')},saveTemplateSuccess: async ({ template }) => {+ if (values.createAsTransactional && template.id) {+ actions.resetTemplate(template)+ actions.setOriginalTemplate(template)+ try {+ await messagingTemplatesMakeTransactionalCreate(String(values.currentTeamIdStrict), template.id, {})+ lemonToast.success('Transactional email created. Send it from the API tab.')+ } catch (error: any) {+ // The template exists either way. Its API tab offers "Make transactional" to try again.+ lemonToast.error(+ `Template created. Couldn't make it transactional: ${error?.detail ?? 'unknown error'}. Try again from the API tab.`+ )+ }+ router.actions.replace(urls.transactionalTemplate(template.id))+ return+ }lemonToast.success(props.id === 'new' ? 'Template created' : values.draftsEnabled ? 'Published' : 'Template saved')@@ -996,7 +1042,7 @@ export const messageTemplateLogic = kea<messageTemplateLogicType>([if (props.id === 'new') {router.actions.push(urls.workflows('library'))} else if (template.id) {- router.actions.replace(urls.workflowsLibraryTemplate(template.id))+ router.actions.replace(templateUrlInSection(template.id, values.section))}actions.replayDeferredExternalEdit()},@@ -1025,7 +1071,7 @@ export const messageTemplateLogic = kea<messageTemplateLogicType>([content: template.content,})lemonToast.success('Template duplicated successfully')- router.actions.push(urls.workflowsLibraryTemplate(duplicatedTemplate.id))+ router.actions.push(templateUrlInSection(duplicatedTemplate.id, values.section))} catch {lemonToast.error('Failed to duplicate template')}@@ -1043,7 +1089,7 @@ export const messageTemplateLogic = kea<messageTemplateLogicType>([},callback: (undo) => {if (!undo) {- router.actions.push(urls.workflows('library'))+ router.actions.push(values.listUrl)}},})diff --git a/products/workflows/frontend/TemplateLibrary/messageTemplateSceneLogic.ts b/products/workflows/frontend/TemplateLibrary/messageTemplateSceneLogic.tsindex a2e0279d1322..b8b5fd458517 100644--- a/products/workflows/frontend/TemplateLibrary/messageTemplateSceneLogic.ts+++ b/products/workflows/frontend/TemplateLibrary/messageTemplateSceneLogic.ts@@ -1,4 +1,4 @@-import { MakeLogicType, kea, path, props, selectors } from 'kea'+import { MakeLogicType, connect, kea, key, path, props, selectors } from 'kea'import { Scene } from 'scenes/sceneTypes'import { urls } from 'scenes/urls'@@ -6,6 +6,9 @@ import { urls } from 'scenes/urls'import { FileSystemIconType } from '~/queries/schema/schema-general'import { Breadcrumb } from '~/types'+import { messageTemplateLogic } from './messageTemplateLogic'+import { TemplateSection, templateLibraryUrl, templateUrlInSection } from './templateSection'+export interface MessageTemplateSceneLogicProps {id: stringmessageId?: string | null@@ -13,13 +16,16 @@ export interface MessageTemplateSceneLogicProps {// Generated by kea-typegen. Update if you're an agent, ignore if you're human.export interface messageTemplateSceneLogicValues {+ isTransactional: boolean // messageTemplateLogic+ section: TemplateSection // messageTemplateLogicbreadcrumbs: Breadcrumb[]}// Generated by kea-typegen. Update if you're an agent, ignore if you're human.export interface messageTemplateSceneLogicMeta {+ key: string__keaTypeGenInternalSelectorTypes: {- breadcrumbs: (id: string) => Breadcrumb[]+ breadcrumbs: (id: string, isTransactional: boolean, section: TemplateSection) => Breadcrumb[]}}@@ -31,36 +37,76 @@ export type messageTemplateSceneLogicType = MakeLogicType<>export const messageTemplateSceneLogic = kea<messageTemplateSceneLogicType>([- path(['products', 'workflows', 'frontend', 'messageTemplateSceneLogic']),props({} as MessageTemplateSceneLogicProps),+ // Keyed like messageTemplateLogic, so the connection below follows the template on screen.+ key(({ id }) => id ?? 'new'),+ path((key) => ['products', 'workflows', 'frontend', 'messageTemplateSceneLogic', key]),+ connect((props: MessageTemplateSceneLogicProps) => ({+ values: [messageTemplateLogic(props), ['isTransactional', 'section']],+ })),selectors({breadcrumbs: [- (_, p) => [p.id],- (id: string): Breadcrumb[] => {- return [- {- key: [Scene.Workflows, 'library'],- name: 'Library',- path: urls.workflows('library'),- iconType: 'workflows',- },- ...(id === 'new'+ (s, p) => [p.id, s.isTransactional, s.section],+ (id: string, isTransactional: boolean, section: TemplateSection): Breadcrumb[] => {+ const sectionCrumbs: Breadcrumb[] =+ section === 'transactional' || (section === 'workflows' && isTransactional)? [{- key: 'new-template',- name: 'New template',- path: urls.workflowsLibraryTemplateNew(),- iconType: 'workflows' as FileSystemIconType,+ key: Scene.Transactional,+ name: 'Transactional',+ path: urls.transactional(),+ iconType: 'transactional',},]- : [- {- key: 'edit-template',- name: 'Manage template',- path: urls.workflowsLibraryTemplate(id),- iconType: 'workflows' as FileSystemIconType,- },- ]),+ : section === 'broadcasts'+ ? [+ {+ key: Scene.Broadcasts,+ name: 'Broadcasts',+ path: urls.broadcasts(),+ iconType: 'broadcasts',+ },+ ]+ : []+ // A transactional email is listed on the Transactional tab itself, so it skips the Templates crumb.+ const libraryCrumb: Breadcrumb[] =+ section === 'workflows'+ ? isTransactional+ ? []+ : [+ {+ key: [Scene.Workflows, 'library'],+ name: 'Library',+ path: urls.workflows('library'),+ iconType: 'workflows',+ },+ ]+ : isTransactional && section === 'transactional'+ ? []+ : [+ {+ key: [section, 'library'],+ name: 'Templates',+ path: templateLibraryUrl(section),+ iconType: section as FileSystemIconType,+ },+ ]+ return [+ ...sectionCrumbs,+ ...libraryCrumb,+ id === 'new'+ ? {+ key: 'new-template',+ name: isTransactional ? 'New transactional email' : 'New template',+ path: urls.workflowsLibraryTemplateNew(),+ iconType: 'workflows' as FileSystemIconType,+ }+ : {+ key: 'edit-template',+ name: isTransactional ? 'Manage transactional email' : 'Manage template',+ path: templateUrlInSection(id, section),+ iconType: 'workflows' as FileSystemIconType,+ },]},],diff --git a/products/workflows/frontend/TemplateLibrary/messageTemplatesLogic.ts b/products/workflows/frontend/TemplateLibrary/messageTemplatesLogic.tsindex b216d5931008..ae6228b23ef7 100644--- a/products/workflows/frontend/TemplateLibrary/messageTemplatesLogic.ts+++ b/products/workflows/frontend/TemplateLibrary/messageTemplatesLogic.ts@@ -23,6 +23,7 @@ export interface messageTemplatesLogicValues {templates: MessageTemplate[]templatesLoading: booleantransactionalOnly: boolean+ transactionalTemplates: MessageTemplate[]}// Generated by kea-typegen. Update if you're an agent, ignore if you're human.@@ -143,6 +144,7 @@ export interface messageTemplatesLogicActions {// Generated by kea-typegen. Update if you're an agent, ignore if you're human.export interface messageTemplatesLogicMeta {__keaTypeGenInternalSelectorTypes: {+ transactionalTemplates: (templates: MessageTemplate[]) => MessageTemplate[]filteredTemplates: (templates: MessageTemplate[],search: string,@@ -253,6 +255,10 @@ export const messageTemplatesLogic = kea<messageTemplatesLogicType>([],})),selectors({+ transactionalTemplates: [+ (s) => [s.templates],+ (templates: MessageTemplate[]): MessageTemplate[] => templates.filter((t) => !!t.transactional_hog_flow_id),+ ],filteredTemplates: [(s) => [s.templates, s.search, s.createdByFilter, s.transactionalOnly, s.tagsFilter],(diff --git a/products/workflows/frontend/TemplateLibrary/newTemplateAgentLogic.ts b/products/workflows/frontend/TemplateLibrary/newTemplateAgentLogic.tsindex 372a617cc524..ca77e00bdbbf 100644--- a/products/workflows/frontend/TemplateLibrary/newTemplateAgentLogic.ts+++ b/products/workflows/frontend/TemplateLibrary/newTemplateAgentLogic.ts@@ -92,6 +92,9 @@ export interface newTemplateAgentLogicActions {startNewTemplate: () => {value: true}+ startNewTransactionalEmail: () => {+ value: true+ }}// Generated by kea-typegen. Update if you're an agent, ignore if you're human.@@ -119,6 +122,9 @@ export type newTemplateAgentLogicType = MakeLogicType<newTemplateAgentLogicMeta>+// pinned: URL search param - the new-template editor reads it to make the template transactional on its first save+export const TRANSACTIONAL_PARAM = 'transactional'+/** Entry, mode and picked starting point for the AI-first "New template" page. */export const newTemplateAgentLogic = kea<newTemplateAgentLogicType>([path(['products', 'workflows', 'frontend', 'library', 'newTemplateAgentLogic']),@@ -135,6 +141,7 @@ export const newTemplateAgentLogic = kea<newTemplateAgentLogicType>([})),actions({startNewTemplate: true,+ startNewTransactionalEmail: true,openEditorFromAiComposer: true,setPickedTemplate: (template: MessageTemplate | null) => ({ template }),}),@@ -187,6 +194,10 @@ export const newTemplateAgentLogic = kea<newTemplateAgentLogicType>([values.aiFirstNewEnabled ? { [EDITOR_MODE_PARAM]: AI_COMPOSER_MODE_VALUE } : {})},+ // Skips the AI composer, which writes a plain template.+ startNewTransactionalEmail: () => {+ router.actions.push(urls.workflowsLibraryTemplateNew(), { [TRANSACTIONAL_PARAM]: 'true' })+ },// The editor URL keeps the composer from rendering again, and the editor opens its picker for it.openEditorFromAiComposer: () => {router.actions.push(urls.workflowsLibraryTemplateNew(), { [EDITOR_MODE_PARAM]: EDITOR_MODE_VALUE })diff --git a/products/workflows/frontend/TemplateLibrary/templateSection.test.ts b/products/workflows/frontend/TemplateLibrary/templateSection.test.tsnew file mode 100644index 000000000000..db5a2f4ae995--- /dev/null+++ b/products/workflows/frontend/TemplateLibrary/templateSection.test.ts@@ -0,0 +1,20 @@+import { templateLibraryUrl, templateSectionFor, templateUrlInSection } from './templateSection'++describe('templateSection', () => {+ test.each([+ ['/project/2/transactional/library', '/transactional/library/templates/t1', '/transactional/library'],+ [+ '/project/2/transactional/library/templates/t9',+ '/transactional/library/templates/t1',+ '/transactional/library',+ ],+ ['/project/2/broadcasts/library', '/broadcasts/library/templates/t1', '/broadcasts/library'],+ ['/project/2/workflows/library', '/workflows/library/templates/t1', '/workflows/library'],+ // A path that only shares the prefix is not the Transactional section.+ ['/project/2/transactionalish/library', '/workflows/library/templates/t1', '/workflows/library'],+ ])('opened from %s keeps links in its section', (pathname, expectedTemplateUrl, expectedLibraryUrl) => {+ const section = templateSectionFor(pathname)+ expect(templateUrlInSection('t1', section)).toBe(expectedTemplateUrl)+ expect(templateLibraryUrl(section)).toBe(expectedLibraryUrl)+ })+})diff --git a/products/workflows/frontend/TemplateLibrary/templateSection.ts b/products/workflows/frontend/TemplateLibrary/templateSection.tsnew file mode 100644index 000000000000..875217205724--- /dev/null+++ b/products/workflows/frontend/TemplateLibrary/templateSection.ts@@ -0,0 +1,38 @@+import { removeProjectIdIfPresent } from 'lib/utils/kea-router'+import { urls } from 'scenes/urls'++/** The nav section a template page belongs to, read from the URL it was opened under. */+export type TemplateSection = 'transactional' | 'broadcasts' | 'workflows'++export function templateSectionFor(pathname: string): TemplateSection {+ const path = removeProjectIdIfPresent(pathname)+ if (path.startsWith('/transactional/')) {+ return 'transactional'+ }+ if (path.startsWith('/broadcasts/')) {+ return 'broadcasts'+ }+ return 'workflows'+}++/** A template's page in the given section, so opening it keeps the nav and back links in place. */+export function templateUrlInSection(id: string, section: TemplateSection): string {+ if (section === 'transactional') {+ return urls.transactionalTemplate(id)+ }+ if (section === 'broadcasts') {+ return urls.broadcastsTemplate(id)+ }+ return urls.workflowsLibraryTemplate(id)+}++/** The Templates tab a template page returns to. */+export function templateLibraryUrl(section: TemplateSection): string {+ if (section === 'transactional') {+ return urls.transactional('library')+ }+ if (section === 'broadcasts') {+ return urls.broadcasts('library')+ }+ return urls.workflows('library')+}diff --git a/products/workflows/frontend/Transactional/TransactionalEmailsTable.tsx b/products/workflows/frontend/Transactional/TransactionalEmailsTable.tsxnew file mode 100644index 000000000000..79cc6f0be270--- /dev/null+++ b/products/workflows/frontend/Transactional/TransactionalEmailsTable.tsx@@ -0,0 +1,112 @@+import { useActions, useMountedLogic, useValues } from 'kea'++import { IconLock } from '@posthog/icons'+import { LemonTag, Link } from '@posthog/lemon-ui'++import { AppMetricsSparkline } from 'lib/components/AppMetrics/AppMetricsSparkline'+import { ProductIntroduction } from 'lib/components/ProductIntroduction/ProductIntroduction'+import { LemonTable, LemonTableColumn } from 'lib/lemon-ui/LemonTable'+import { updatedAtColumn } from 'lib/lemon-ui/LemonTable/columnUtils'+import { LemonTableLink } from 'lib/lemon-ui/LemonTable/LemonTableLink'+import { getAccessControlDisabledReason } from 'lib/utils/accessControlUtils'+import { urls } from 'scenes/urls'++import { AccessControlLevel, AccessControlResourceType } from '~/types'++import { messageTemplatesLogic } from '../TemplateLibrary/messageTemplatesLogic'+import { newTemplateAgentLogic } from '../TemplateLibrary/newTemplateAgentLogic'+import { MessageTemplate } from '../TemplateLibrary/types'++export function TransactionalEmailsTable(): JSX.Element {+ useMountedLogic(messageTemplatesLogic)+ const { transactionalTemplates, templatesLoading } = useValues(messageTemplatesLogic)+ const { startNewTransactionalEmail } = useActions(newTemplateAgentLogic)++ if (!templatesLoading && transactionalTemplates.length === 0) {+ return (+ <ProductIntroduction+ thingName="transactional email"+ description="Send emails from your code with one API call. Use them for emails a person triggers, like password resets, receipts and sign-in codes. This tab shows how many were sent, delivered and failed in the last 7 days."+ docsURL="https://posthog.com/docs/workflows"+ action={startNewTransactionalEmail}+ disabledReason={+ getAccessControlDisabledReason(AccessControlResourceType.Workflow, AccessControlLevel.Editor) ??+ undefined+ }+ isEmpty+ />+ )+ }++ return (+ <LemonTable<MessageTemplate>+ dataSource={transactionalTemplates}+ loading={templatesLoading}+ rowKey="id"+ data-attr="transactional-emails-table"+ columns={[+ {+ title: 'Name',+ key: 'name',+ sorter: (a, b) => (a.name || '').localeCompare(b.name || ''),+ render: (_, template) => (+ <LemonTableLink+ to={urls.transactionalTemplate(template.id)}+ title={+ <span className="flex items-center gap-1">+ {template.name || 'Unnamed template'}+ {template.sensitive && (+ <LemonTag type="highlight" size="small" icon={<IconLock />}>+ Sensitive+ </LemonTag>+ )}+ {template.draft_content && (+ <LemonTag type="warning" size="small">+ Unpublished changes+ </LemonTag>+ )}+ </span>+ }+ description={template.description}+ />+ ),+ },+ {+ title: 'Last 7 days',+ width: 0,+ render: (_, template) =>+ template.transactional_hog_flow_id ? (+ <Link to={urls.transactionalTemplate(template.id)}>+ <AppMetricsSparkline+ logicKey={`transactional-${template.id}`}+ // Lines, not stacked bars: a delivered or failed email was also counted as sent.+ type="line"+ metricLabels={{+ email_sent: 'Sent',+ email_delivered: 'Delivered',+ email_failed: 'Failed',+ }}+ metricColors={{+ email_sent: 'blue',+ email_delivered: 'success',+ email_failed: 'danger',+ }}+ forceParams={{+ appSource: 'hog_flow',+ appSourceId: template.transactional_hog_flow_id,+ metricName: ['email_sent', 'email_delivered', 'email_failed'],+ breakdownBy: 'metric_name',+ interval: 'day',+ dateFrom: '-7d',+ }}+ />+ </Link>+ ) : null,+ },+ { ...(updatedAtColumn() as LemonTableColumn<MessageTemplate, any>), width: 0 },+ ]}+ defaultSorting={{ columnKey: 'updated_at', order: -1 }}+ emptyState="No transactional emails match"+ />+ )+}diff --git a/products/workflows/frontend/Transactional/TransactionalScene.tsx b/products/workflows/frontend/Transactional/TransactionalScene.tsxnew file mode 100644index 000000000000..721fe5597b3e--- /dev/null+++ b/products/workflows/frontend/Transactional/TransactionalScene.tsx@@ -0,0 +1,119 @@+import { useActions, useValues } from 'kea'+import { router } from 'kea-router'++import { LemonButton } from '@posthog/lemon-ui'+import { Button } from '@posthog/quill'++import { AccessControlAction } from 'lib/components/AccessControlAction'+import { NotFound } from 'lib/components/NotFound'+import { useFeatureFlag } from 'lib/hooks/useFeatureFlag'+import { LemonTabs } from 'lib/lemon-ui/LemonTabs'+import { SceneExport } from 'scenes/sceneTypes'+import { urls } from 'scenes/urls'++import { SceneContent } from '~/layout/scenes/components/SceneContent'+import { SceneTitleSection } from '~/layout/scenes/components/SceneTitleSection'+import { ProductKey } from '~/queries/schema/schema-general'+import { AccessControlLevel, AccessControlResourceType } from '~/types'++import { EmailSuspensionBanner } from '../EmailSuspensionBanner'+import { MessagingSetup } from '../MessagingSetup'+import { MessagingTabActions } from '../MessagingTabActions'+import {+ MESSAGING_NAV_TAB_KEYS,+ MESSAGING_TAB_CONTENT,+ MessagingNavTabKey,+ isMessagingSetupTab,+} from '../messagingTabs'+import { newTemplateAgentLogic } from '../TemplateLibrary/newTemplateAgentLogic'+import { TransactionalEmailsTable } from './TransactionalEmailsTable'++export const scene: SceneExport = {+ component: TransactionalScene,+ productKey: ProductKey.WORKFLOWS,+}++export function TransactionalScene(): JSX.Element {+ const { location } = useValues(router)+ const { startNewTransactionalEmail } = useActions(newTemplateAgentLogic)+ const showTransactional = useFeatureFlag('WORKFLOWS_TRANSACTIONAL_EMAIL_API')+ const todayRailNav = useFeatureFlag('TODAY_RAIL_NAV')+ // The tab routes are literal paths, so the tab is the last path segment rather than a route param.+ const lastSegment = location.pathname.split('/').pop() as MessagingNavTabKey+ const currentTab: MessagingNavTabKey | 'transactional' = MESSAGING_NAV_TAB_KEYS.includes(lastSegment)+ ? lastSegment+ : 'transactional'++ if (!showTransactional) {+ return <NotFound object="page" />+ }++ return (+ <SceneContent>+ <SceneTitleSection+ name="Transactional"+ description="Send emails from your code with one API call"+ resourceType={{ type: 'transactional' }}+ actions={+ currentTab === 'transactional' ? (+ <AccessControlAction+ resourceType={AccessControlResourceType.Workflow}+ minAccessLevel={AccessControlLevel.Editor}+ >+ {todayRailNav ? (+ <Button+ data-attr="new-transactional-email"+ onClick={startNewTransactionalEmail}+ variant="primary"+ >+ New transactional email+ </Button>+ ) : (+ <LemonButton+ data-attr="new-transactional-email"+ onClick={startNewTransactionalEmail}+ type="primary"+ size="small"+ >+ New transactional email+ </LemonButton>+ )}+ </AccessControlAction>+ ) : (+ <MessagingTabActions tab={currentTab} channelsUrl={urls.transactional('channels')} />+ )+ }+ />+ <EmailSuspensionBanner />+ <LemonTabs<'transactional' | 'library' | 'messaging-setup'>+ activeKey={currentTab === 'transactional' || currentTab === 'library' ? currentTab : 'messaging-setup'}+ tabs={[+ {+ label: 'Transactional emails',+ key: 'transactional',+ link: urls.transactional(),+ content: <TransactionalEmailsTable />,+ },+ {+ label: 'Templates',+ key: 'library',+ link: urls.transactional('library'),+ content: MESSAGING_TAB_CONTENT.library,+ },+ {+ label: 'Messaging',+ key: 'messaging-setup',+ link: urls.transactional('channels'),+ content: (+ <MessagingSetup+ tab={isMessagingSetupTab(currentTab) ? currentTab : 'channels'}+ linkFor={(tab) => urls.transactional(tab)}+ />+ ),+ },+ ]}+ sceneInset+ />+ </SceneContent>+ )+}diff --git a/products/workflows/manifest.tsx b/products/workflows/manifest.tsxindex 7685fdf87c01..64bf7e640554 100644--- a/products/workflows/manifest.tsx+++ b/products/workflows/manifest.tsx@@ -1,3 +1,4 @@+import { FEATURE_FLAGS } from 'lib/constants'import { urls } from 'scenes/urls'import { ProductItemCategory, ProductKey } from '~/queries/schema/schema-general'@@ -43,6 +44,13 @@ export const manifest: ProductManifest = {projectBased: true,description: 'Send a one-time or scheduled email to a group of people',},+ Transactional: {+ import: () => import('./frontend/Transactional/TransactionalScene'),+ name: 'Transactional',+ iconType: 'transactional',+ projectBased: true,+ description: 'Send emails from your code with one API call',+ },WorkflowsEmailDomain: {import: () => import('./frontend/Channels/EmailDomain/EmailDomainScene'),name: 'Workflows',@@ -71,6 +79,16 @@ export const manifest: ProductManifest = {'/broadcasts/reputation': ['Broadcasts', 'broadcasts'],'/broadcasts/settings': ['Broadcasts', 'broadcasts'],'/broadcasts/calendar': ['Broadcasts', 'broadcasts'],+ '/transactional': ['Transactional', 'transactional'],+ '/transactional/library': ['Transactional', 'transactional'],+ '/transactional/channels': ['Transactional', 'transactional'],+ '/transactional/opt-outs': ['Transactional', 'transactional'],+ '/transactional/suppression': ['Transactional', 'transactional'],+ '/transactional/reputation': ['Transactional', 'transactional'],+ '/transactional/settings': ['Transactional', 'transactional'],+ // A template opened from a section's Templates tab stays in that section.+ '/transactional/library/templates/:id': ['WorkflowsLibraryTemplate', 'workflowsLibraryTemplate'],+ '/broadcasts/library/templates/:id': ['WorkflowsLibraryTemplate', 'workflowsLibraryTemplate'],// kea-router matches in declaration order, so the literal 'new' comes before ':id'.'/broadcasts/new': ['Broadcast', 'broadcast'],'/broadcasts/:id': ['Broadcast', 'broadcast'],@@ -88,6 +106,9 @@ export const manifest: ProductManifest = {broadcasts: (tab?: MessagingNavTabKey | 'calendar'): string => `/broadcasts${tab ? `/${tab}` : ''}`,broadcast: (id: string): string => `/broadcasts/${id}`,broadcastNew: (): string => '/broadcasts/new',+ transactional: (tab?: MessagingNavTabKey): string => `/transactional${tab ? `/${tab}` : ''}`,+ transactionalTemplate: (id: string): string => `/transactional/library/templates/${id}`,+ broadcastsTemplate: (id: string): string => `/broadcasts/library/templates/${id}`,},fileSystemTypes: {workflows: {@@ -128,5 +149,16 @@ export const manifest: ProductManifest = {iconColor: ['var(--color-product-broadcasts-light)', 'var(--color-product-broadcasts-dark)'],sceneKey: 'Broadcasts',},+ {+ path: 'Transactional',+ intents: [ProductKey.WORKFLOWS],+ href: urls.transactional(),+ type: 'transactional',+ category: ProductItemCategory.MESSAGING,+ iconType: 'transactional',+ iconColor: ['var(--color-product-workflows-light)', 'var(--color-product-workflows-dark)'],+ sceneKey: 'Transactional',+ flag: FEATURE_FLAGS.WORKFLOWS_TRANSACTIONAL_EMAIL_API,+ },],}diff --git a/services/mcp/src/tools/links/app-url-manifest.json b/services/mcp/src/tools/links/app-url-manifest.jsonindex 72676674ad22..e655f0928e70 100644--- a/services/mcp/src/tools/links/app-url-manifest.json+++ b/services/mcp/src/tools/links/app-url-manifest.json@@ -324,6 +324,11 @@"params": [],"scope": "project"},+ "broadcastsTemplate": {+ "template": "/broadcasts/library/templates/{id}",+ "params": ["id"],+ "scope": "project"+ },"businessIntelligence": {"template": "/bi","params": [],@@ -1839,6 +1844,16 @@"params": [],"scope": "project"},+ "transactional": {+ "template": "/transactional",+ "params": [],+ "scope": "project"+ },+ "transactionalTemplate": {+ "template": "/transactional/library/templates/{id}",+ "params": ["id"],+ "scope": "project"+ },"transformations": {"template": "/data-management/transformations","params": [],diff --git a/services/mcp/tests/unit/__snapshots__/tool-schemas/generate-app-url.json b/services/mcp/tests/unit/__snapshots__/tool-schemas/generate-app-url.jsonindex 755575cb7307..d05a4e0eba6c 100644--- a/services/mcp/tests/unit/__snapshots__/tool-schemas/generate-app-url.json+++ b/services/mcp/tests/unit/__snapshots__/tool-schemas/generate-app-url.json@@ -13,7 +13,7 @@"type": "object"},"url": {- "description": "A path template copied verbatim from the catalog below (e.g. `/persons/{uuid}`). Its `{placeholders}` are filled from `params`. These slugs come from PostHog's canonical route table, so they are always correct — never pass a path that is not in this list.\n\n/account-connected/{kind}\n/account/credential-review\n/account/social-connected\n/activity-logs\n/activity/{tab}\n/agentic/account-mismatch\n/agentic/authorize\n/ai\n/ai-enrichment\n/ai-evals/evaluations\n/ai-evals/evaluations/offline/datasets/{id}\n/ai-evals/evaluations/offline/experiments\n/ai-evals/evaluations/offline/experiments/{experimentId}\n/ai-evals/evaluations/offline/experiments?tab=datasets\n/ai-evals/evaluations/scorers\n/ai-evals/evaluations/scorers/{scorerId}\n/ai-evals/evaluations/scorers/{scorerId}/offline\n/ai-evals/evaluations/templates\n/ai-evals/evaluations/{id}\n/ai-evals/taggers\n/ai-evals/taggers/{id}\n/ai-observability/clusters\n/ai-observability/clusters/{runId}/{clusterId}\n/ai-observability/dashboard\n/ai-observability/errors\n/ai-observability/generations\n/ai-observability/playground\n/ai-observability/reviews\n/ai-observability/self-driving\n/ai-observability/sentiment\n/ai-observability/sessions\n/ai-observability/sessions/{id}\n/ai-observability/tools\n/ai-observability/traces\n/ai-observability/traces/{id}\n/ai-observability/users\n/ai/history\n/alerts\n/analytics\n/analytics/all\n/analytics/mine\n/analytics/product-analytics\n/analytics/spaces\n/application-observability\n/approvals/{id}\n/autoresearch\n/autoresearch/new\n/autoresearch/{id}\n/bi\n/bi/new\n/bi/{insightShortId}\n/billing/authorization_status\n/broadcasts\n/broadcasts/new\n/broadcasts/{id}\n/business-knowledge\n/business-knowledge/playground\n/business-knowledge/settings\n/business-knowledge/{id}\n/canvas\n/canvases\n/canvases/new\n/canvases/{id}\n/cli/authorize\n/cli/live\n/code-review\n/code/canvas/{channelId}/{dashboardId}\n/code/channel/{channelId}\n/code/loop/{loopId}\n/code/task/{taskId}\n/cohorts\n/cohorts/{id}\n/cohorts/{id}/calculation-history\n/connect/vercel/link\n/coupons/{campaign}\n/create-organization\n/cross-project-dashboards\n/cross-project-dashboards/{id}\n/customer_analytics\n/customer_analytics/accounts\n/customer_analytics/accounts/by-external-id/{externalId}\n/customer_analytics/accounts/{accountId}\n/customer_analytics/announcements\n/customer_analytics/configuration\n/customer_analytics/dashboard\n/customer_analytics/feature-requests\n/customer_analytics/feed\n/customer_analytics/journeys\n/customer_analytics/journeys/new\n/customer_analytics/journeys/templates\n/customer_analytics/journeys/{id}/edit\n/customer_analytics/notes\n/customer_analytics/tasks\n/dashboard\n/dashboard/templates/{templateId}/copy-to-project\n/dashboard/{id}\n/dashboard/{id}/sharing\n/dashboard/{id}/subscriptions\n/dashboard/{id}/subscriptions/{subscriptionId}\n/dashboard/{id}/tiles/{tileId}\n/data-catalog\n/data-catalog/metrics/{name}\n/data-catalog/new-metric\n/data-management/actions\n/data-management/actions/new\n/data-management/actions/new/\n/data-management/actions/{id}\n/data-management/annotations\n/data-management/annotations/{id}\n/data-management/core-events\n/data-management/database\n/data-management/destinations\n/data-management/event-filtering\n/data-management/events\n/data-management/events/{id}\n/data-management/events/{id}/edit\n/data-management/history\n/data-management/ingestion-warnings\n/data-management/ingestion-warnings-v2\n/data-management/managed-viewsets\n/data-management/materialized-columns\n/data-management/properties\n/data-management/properties/{id}\n/data-management/properties/{id}/edit\n/data-management/revenue\n/data-management/schema\n/data-management/sources\n/data-management/sources/{id}/schemas\n/data-management/sources/{sourceId}/schemas/{schemaId}\n/data-management/transformations\n/data-management/variables\n/data-management/variables/{id}\n/data-management/variables/{id}/edit\n/data-management/warehouse-destinations\n/data-management/warehouse-properties\n/data-ops\n/data-warehouse/connect\n/data-warehouse/new-source\n/debug\n/debug/hog\n/debug/precompute\n/early_access_features\n/early_access_features/{id}\n/embedded/{token}\n/endpoints\n/endpoints/{name}\n/engineering-analytics/authors\n/engineering-analytics/authors/{handle}\n/engineering-analytics/deploys\n/engineering-analytics/overview\n/engineering-analytics/pull-requests\n/engineering-analytics/repos/{repoOwner}/{repoName}/actions/runs/{runId}\n/engineering-analytics/repos/{repoOwner}/{repoName}/actions/workflows/{workflowName}\n/engineering-analytics/repos/{repoOwner}/{repoName}/pull-requests/{number}\n/engineering-analytics/repos/{repoOwner}/{repoName}/pull-requests/{number}/ci-explorer\n/engineering-analytics/teams\n/engineering-analytics/teams/{ownerTeam}\n/engineering-analytics/tests\n/engineering-analytics/workflows\n/error-tracking\n/error-tracking/alerts/new/{templateId}\n/error-tracking/alerts/{id}\n/error-tracking/fingerprint/{fingerprint}\n/error-tracking/{id}\n/etl\n/events/{id}/{timestamp}\n/experiments\n/experiments/shared-metrics\n/experiments/shared-metrics/{id}\n/experiments/staff\n/experiments/{id}\n/exports\n/feature-flags\n/feature-flags/new\n/feature-flags/staff\n/feature-flags/staff/cohorts\n/feature-flags/templates\n/feature-flags/{id}\n/files\n/functions/new/{templateId}\n/functions/{id}\n/games/368hedgehogs\n/games/flappyhog\n/games/shipit\n/groups/{groupTypeIndex}\n/groups/{groupTypeIndex}/new\n/groups/{groupTypeIndex}/{groupKey}\n/health\n/health/alerts\n/health/pipeline-status\n/health/sdk-health\n/health/{category}\n/heatmaps\n/heatmaps/new\n/heatmaps/recording\n/heatmaps/{id}\n/home\n/identity-matching\n/inbox\n/inbox/reports/triage\n/inbox/scout-trials\n/inbox/scouts/findings\n/inbox/scouts/runs\n/inbox/scouts/scratchpad\n/inbox/scouts/{skillName}\n/inbox/{tab}/{reportId}\n/insights\n/insights/new\n/insights/quick-start\n/insights/{id}\n/insights/{id}/edit\n/insights/{id}/sharing\n/insights/{id}/subscriptions\n/insights/{id}/subscriptions/{subscriptionId}\n/insights/{insightShortId}/alerts\n/instance/async_migrations\n/instance/async_migrations/future\n/instance/async_migrations/settings\n/instance/dead_letter_queue\n/instance/kafka_inspector\n/instance/metrics\n/instance/settings\n/instance/staff_users\n/instance/status\n/integrations/stripe/confirm-install\n/integrations/vercel/link-error\n/integrations/{kind}/callback\n/integrations/{slug}\n/legal\n/legal/new/{type}\n/login\n/login/2fa\n/login/2fa_setup\n/logs\n/logs/alerts/{alertId}/notifications/{hogFunctionId}\n/logs/alerts/{id}\n/logs/drop-rules/new\n/logs/drop-rules/{id}\n/logs/retention-rules/new\n/logs/retention-rules/{id}\n/managed_migrations\n/managed_migrations/new\n/marketing\n/mcp-analytics\n/mcp-analytics/activity\n/mcp-analytics/dashboard\n/mcp-analytics/intent-clustering\n/mcp-analytics/missing-capabilities\n/mcp-analytics/notifications\n/mcp-analytics/sessions\n/mcp-analytics/tool-quality\n/mcp-analytics/tool-quality/{toolName}\n/mcp-registry\n/mcp-servers\n/mcp-servers/agent/{id}\n/mcp-servers/member/{id}\n/mcp-servers/server/{id}\n/mcp-servers/{tab}\n/metrics\n/metrics/dashboard-review\n/models\n/models/{id}\n/move-to-cloud\n/my-tickets\n/notebooks\n/notebooks/widgets/{widgetId}\n/notebooks/{shortId}\n/oauth/authorize\n/onboarding\n/onboarding/simple\n/organization-deactivated\n/organization-pending-deletion\n/organization/billing\n/organization/billing/overview\n/organization/billing/real-time-usage\n/organization/confirm-creation\n/organization/create-project\n/organization/legal\n/organization/startups\n/person/{id}\n/persons\n/persons/{uuid}\n/pipeline/batch-exports/new/{service}\n/pipeline/batch-exports/{id}\n/pipeline/new/\n/pipeline/plugins/{id}\n/platform-alerts\n/platform-alerts/{id}\n/preflight\n/product_tours\n/product_tours/{id}\n/project-pending-deletion\n/prompt-management/prompts\n/prompt-management/prompts/{name}\n/pulse\n/replay-vision\n/replay-vision/new/goal\n/replay-vision/observations/{observationId}\n/replay-vision/{id}/budget\n/replay-vision/{id}/configure\n/replay-vision/{id}/details\n/replay-vision/{id}/goal\n/replay-vision/{id}/overview\n/replay-vision/{id}/triggers\n/replay/file-playback\n/replay/home\n/replay/kiosk\n/replay/playlists/{id}\n/replay/settings\n/replay/{id}\n/reset\n/reset/{userUuid}/{token}\n/reset_2fa/{userUuid}/{token}\n/resource-transfer/{resourceKind}/{resourceId}\n/sessions/{id}\n/settings/environment-approvals\n/settings/organization-authentication/{feature}/{configId}\n/settings/project\n/settings/user-feature-previews\n/shared/{token}\n/shared_dashboard/{shareToken}\n/signup\n/signup/{id}\n/site/{url}\n/skills\n/skills/community\n/skills/{categoryTab}\n/skills/{name}\n/slack-task-context\n/spaces\n/spaces/new\n/spaces/{id}\n/spaces/{id}/canvases\n/spaces/{id}/new\n/spaces/{id}/settings\n/sql\n/stamphog\n/stamphog/digests\n/stamphog/install/callback\n/stamphog/runs\n/startups\n/streamlit-apps\n/streamlit-apps/new\n/streamlit-apps/{id}\n/streamlit-apps/{id}/edit\n/subscriptions\n/subscriptions/new\n/subscriptions/{id}\n/subscriptions/{id}/edit\n/support\n/support/settings\n/support/tickets\n/support/tickets/{ticketId}\n/surveys\n/surveys/form/new\n/surveys/guided/new\n/surveys/{id}\n/tasks\n/tasks/new\n/tasks/{taskId}\n/terminal\n/themes/custom-css\n/toolbar\n/tools\n/tracing\n/tracing/retention-rules/new\n/tracing/retention-rules/{id}\n/unsubscribe\n/uptime-monitoring\n/verify_email\n/visual-review\n/visual-review/repos/{repoOwner}/{repoName}/flakiness\n/visual-review/repos/{repoOwner}/{repoName}/runs\n/visual-review/repos/{repoOwner}/{repoName}/runs/{runId}\n/visual-review/repos/{repoOwner}/{repoName}/snapshots\n/visual-review/repos/{repoOwner}/{repoName}/{runType}/snapshots/{identifier}\n/visual-review/runs/{runId}\n/visual-review/settings\n/web\n/web-scripts\n/web-scripts/new\n/web/agents\n/web/bots\n/web/content-autopilot\n/web/health\n/web/live\n/web/marketing\n/web/page-performance\n/web/page-reports\n/web/recap\n/web/session-attribution-explorer\n/web/web-vitals\n/welcome\n/wizard/runs\n/workflows\n/workflows/channels/email/{id}\n/workflows/library/messages/{id}\n/workflows/library/templates/new\n/workflows/library/templates/{id}\n/workflows/new/workflow\n/workflows/{id}/{tab}",+ "description": "A path template copied verbatim from the catalog below (e.g. `/persons/{uuid}`). Its `{placeholders}` are filled from `params`. These slugs come from PostHog's canonical route table, so they are always correct — never pass a path that is not in this list.\n\n/account-connected/{kind}\n/account/credential-review\n/account/social-connected\n/activity-logs\n/activity/{tab}\n/agentic/account-mismatch\n/agentic/authorize\n/ai\n/ai-enrichment\n/ai-evals/evaluations\n/ai-evals/evaluations/offline/datasets/{id}\n/ai-evals/evaluations/offline/experiments\n/ai-evals/evaluations/offline/experiments/{experimentId}\n/ai-evals/evaluations/offline/experiments?tab=datasets\n/ai-evals/evaluations/scorers\n/ai-evals/evaluations/scorers/{scorerId}\n/ai-evals/evaluations/scorers/{scorerId}/offline\n/ai-evals/evaluations/templates\n/ai-evals/evaluations/{id}\n/ai-evals/taggers\n/ai-evals/taggers/{id}\n/ai-observability/clusters\n/ai-observability/clusters/{runId}/{clusterId}\n/ai-observability/dashboard\n/ai-observability/errors\n/ai-observability/generations\n/ai-observability/playground\n/ai-observability/reviews\n/ai-observability/self-driving\n/ai-observability/sentiment\n/ai-observability/sessions\n/ai-observability/sessions/{id}\n/ai-observability/tools\n/ai-observability/traces\n/ai-observability/traces/{id}\n/ai-observability/users\n/ai/history\n/alerts\n/analytics\n/analytics/all\n/analytics/mine\n/analytics/product-analytics\n/analytics/spaces\n/application-observability\n/approvals/{id}\n/autoresearch\n/autoresearch/new\n/autoresearch/{id}\n/bi\n/bi/new\n/bi/{insightShortId}\n/billing/authorization_status\n/broadcasts\n/broadcasts/library/templates/{id}\n/broadcasts/new\n/broadcasts/{id}\n/business-knowledge\n/business-knowledge/playground\n/business-knowledge/settings\n/business-knowledge/{id}\n/canvas\n/canvases\n/canvases/new\n/canvases/{id}\n/cli/authorize\n/cli/live\n/code-review\n/code/canvas/{channelId}/{dashboardId}\n/code/channel/{channelId}\n/code/loop/{loopId}\n/code/task/{taskId}\n/cohorts\n/cohorts/{id}\n/cohorts/{id}/calculation-history\n/connect/vercel/link\n/coupons/{campaign}\n/create-organization\n/cross-project-dashboards\n/cross-project-dashboards/{id}\n/customer_analytics\n/customer_analytics/accounts\n/customer_analytics/accounts/by-external-id/{externalId}\n/customer_analytics/accounts/{accountId}\n/customer_analytics/announcements\n/customer_analytics/configuration\n/customer_analytics/dashboard\n/customer_analytics/feature-requests\n/customer_analytics/feed\n/customer_analytics/journeys\n/customer_analytics/journeys/new\n/customer_analytics/journeys/templates\n/customer_analytics/journeys/{id}/edit\n/customer_analytics/notes\n/customer_analytics/tasks\n/dashboard\n/dashboard/templates/{templateId}/copy-to-project\n/dashboard/{id}\n/dashboard/{id}/sharing\n/dashboard/{id}/subscriptions\n/dashboard/{id}/subscriptions/{subscriptionId}\n/dashboard/{id}/tiles/{tileId}\n/data-catalog\n/data-catalog/metrics/{name}\n/data-catalog/new-metric\n/data-management/actions\n/data-management/actions/new\n/data-management/actions/new/\n/data-management/actions/{id}\n/data-management/annotations\n/data-management/annotations/{id}\n/data-management/core-events\n/data-management/database\n/data-management/destinations\n/data-management/event-filtering\n/data-management/events\n/data-management/events/{id}\n/data-management/events/{id}/edit\n/data-management/history\n/data-management/ingestion-warnings\n/data-management/ingestion-warnings-v2\n/data-management/managed-viewsets\n/data-management/materialized-columns\n/data-management/properties\n/data-management/properties/{id}\n/data-management/properties/{id}/edit\n/data-management/revenue\n/data-management/schema\n/data-management/sources\n/data-management/sources/{id}/schemas\n/data-management/sources/{sourceId}/schemas/{schemaId}\n/data-management/transformations\n/data-management/variables\n/data-management/variables/{id}\n/data-management/variables/{id}/edit\n/data-management/warehouse-destinations\n/data-management/warehouse-properties\n/data-ops\n/data-warehouse/connect\n/data-warehouse/new-source\n/debug\n/debug/hog\n/debug/precompute\n/early_access_features\n/early_access_features/{id}\n/embedded/{token}\n/endpoints\n/endpoints/{name}\n/engineering-analytics/authors\n/engineering-analytics/authors/{handle}\n/engineering-analytics/deploys\n/engineering-analytics/overview\n/engineering-analytics/pull-requests\n/engineering-analytics/repos/{repoOwner}/{repoName}/actions/runs/{runId}\n/engineering-analytics/repos/{repoOwner}/{repoName}/actions/workflows/{workflowName}\n/engineering-analytics/repos/{repoOwner}/{repoName}/pull-requests/{number}\n/engineering-analytics/repos/{repoOwner}/{repoName}/pull-requests/{number}/ci-explorer\n/engineering-analytics/teams\n/engineering-analytics/teams/{ownerTeam}\n/engineering-analytics/tests\n/engineering-analytics/workflows\n/error-tracking\n/error-tracking/alerts/new/{templateId}\n/error-tracking/alerts/{id}\n/error-tracking/fingerprint/{fingerprint}\n/error-tracking/{id}\n/etl\n/events/{id}/{timestamp}\n/experiments\n/experiments/shared-metrics\n/experiments/shared-metrics/{id}\n/experiments/staff\n/experiments/{id}\n/exports\n/feature-flags\n/feature-flags/new\n/feature-flags/staff\n/feature-flags/staff/cohorts\n/feature-flags/templates\n/feature-flags/{id}\n/files\n/functions/new/{templateId}\n/functions/{id}\n/games/368hedgehogs\n/games/flappyhog\n/games/shipit\n/groups/{groupTypeIndex}\n/groups/{groupTypeIndex}/new\n/groups/{groupTypeIndex}/{groupKey}\n/health\n/health/alerts\n/health/pipeline-status\n/health/sdk-health\n/health/{category}\n/heatmaps\n/heatmaps/new\n/heatmaps/recording\n/heatmaps/{id}\n/home\n/identity-matching\n/inbox\n/inbox/reports/triage\n/inbox/scout-trials\n/inbox/scouts/findings\n/inbox/scouts/runs\n/inbox/scouts/scratchpad\n/inbox/scouts/{skillName}\n/inbox/{tab}/{reportId}\n/insights\n/insights/new\n/insights/quick-start\n/insights/{id}\n/insights/{id}/edit\n/insights/{id}/sharing\n/insights/{id}/subscriptions\n/insights/{id}/subscriptions/{subscriptionId}\n/insights/{insightShortId}/alerts\n/instance/async_migrations\n/instance/async_migrations/future\n/instance/async_migrations/settings\n/instance/dead_letter_queue\n/instance/kafka_inspector\n/instance/metrics\n/instance/settings\n/instance/staff_users\n/instance/status\n/integrations/stripe/confirm-install\n/integrations/vercel/link-error\n/integrations/{kind}/callback\n/integrations/{slug}\n/legal\n/legal/new/{type}\n/login\n/login/2fa\n/login/2fa_setup\n/logs\n/logs/alerts/{alertId}/notifications/{hogFunctionId}\n/logs/alerts/{id}\n/logs/drop-rules/new\n/logs/drop-rules/{id}\n/logs/retention-rules/new\n/logs/retention-rules/{id}\n/managed_migrations\n/managed_migrations/new\n/marketing\n/mcp-analytics\n/mcp-analytics/activity\n/mcp-analytics/dashboard\n/mcp-analytics/intent-clustering\n/mcp-analytics/missing-capabilities\n/mcp-analytics/notifications\n/mcp-analytics/sessions\n/mcp-analytics/tool-quality\n/mcp-analytics/tool-quality/{toolName}\n/mcp-registry\n/mcp-servers\n/mcp-servers/agent/{id}\n/mcp-servers/member/{id}\n/mcp-servers/server/{id}\n/mcp-servers/{tab}\n/metrics\n/metrics/dashboard-review\n/models\n/models/{id}\n/move-to-cloud\n/my-tickets\n/notebooks\n/notebooks/widgets/{widgetId}\n/notebooks/{shortId}\n/oauth/authorize\n/onboarding\n/onboarding/simple\n/organization-deactivated\n/organization-pending-deletion\n/organization/billing\n/organization/billing/overview\n/organization/billing/real-time-usage\n/organization/confirm-creation\n/organization/create-project\n/organization/legal\n/organization/startups\n/person/{id}\n/persons\n/persons/{uuid}\n/pipeline/batch-exports/new/{service}\n/pipeline/batch-exports/{id}\n/pipeline/new/\n/pipeline/plugins/{id}\n/platform-alerts\n/platform-alerts/{id}\n/preflight\n/product_tours\n/product_tours/{id}\n/project-pending-deletion\n/prompt-management/prompts\n/prompt-management/prompts/{name}\n/pulse\n/replay-vision\n/replay-vision/new/goal\n/replay-vision/observations/{observationId}\n/replay-vision/{id}/budget\n/replay-vision/{id}/configure\n/replay-vision/{id}/details\n/replay-vision/{id}/goal\n/replay-vision/{id}/overview\n/replay-vision/{id}/triggers\n/replay/file-playback\n/replay/home\n/replay/kiosk\n/replay/playlists/{id}\n/replay/settings\n/replay/{id}\n/reset\n/reset/{userUuid}/{token}\n/reset_2fa/{userUuid}/{token}\n/resource-transfer/{resourceKind}/{resourceId}\n/sessions/{id}\n/settings/environment-approvals\n/settings/organization-authentication/{feature}/{configId}\n/settings/project\n/settings/user-feature-previews\n/shared/{token}\n/shared_dashboard/{shareToken}\n/signup\n/signup/{id}\n/site/{url}\n/skills\n/skills/community\n/skills/{categoryTab}\n/skills/{name}\n/slack-task-context\n/spaces\n/spaces/new\n/spaces/{id}\n/spaces/{id}/canvases\n/spaces/{id}/new\n/spaces/{id}/settings\n/sql\n/stamphog\n/stamphog/digests\n/stamphog/install/callback\n/stamphog/runs\n/startups\n/streamlit-apps\n/streamlit-apps/new\n/streamlit-apps/{id}\n/streamlit-apps/{id}/edit\n/subscriptions\n/subscriptions/new\n/subscriptions/{id}\n/subscriptions/{id}/edit\n/support\n/support/settings\n/support/tickets\n/support/tickets/{ticketId}\n/surveys\n/surveys/form/new\n/surveys/guided/new\n/surveys/{id}\n/tasks\n/tasks/new\n/tasks/{taskId}\n/terminal\n/themes/custom-css\n/toolbar\n/tools\n/tracing\n/tracing/retention-rules/new\n/tracing/retention-rules/{id}\n/transactional\n/transactional/library/templates/{id}\n/unsubscribe\n/uptime-monitoring\n/verify_email\n/visual-review\n/visual-review/repos/{repoOwner}/{repoName}/flakiness\n/visual-review/repos/{repoOwner}/{repoName}/runs\n/visual-review/repos/{repoOwner}/{repoName}/runs/{runId}\n/visual-review/repos/{repoOwner}/{repoName}/snapshots\n/visual-review/repos/{repoOwner}/{repoName}/{runType}/snapshots/{identifier}\n/visual-review/runs/{runId}\n/visual-review/settings\n/web\n/web-scripts\n/web-scripts/new\n/web/agents\n/web/bots\n/web/content-autopilot\n/web/health\n/web/live\n/web/marketing\n/web/page-performance\n/web/page-reports\n/web/recap\n/web/session-attribution-explorer\n/web/web-vitals\n/welcome\n/wizard/runs\n/workflows\n/workflows/channels/email/{id}\n/workflows/library/messages/{id}\n/workflows/library/templates/new\n/workflows/library/templates/{id}\n/workflows/new/workflow\n/workflows/{id}/{tab}","type": "string"}},