: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): add the transactional email page (#129260)
Daniel Marchuk1cfa2bb4a9a7
diff --git a/frontend/src/productScenes.tsx b/frontend/src/productScenes.tsxindex 8d6a874666fd..9523ac895a6a 100644--- a/frontend/src/productScenes.tsx+++ b/frontend/src/productScenes.tsx@@ -221,5 +221,7 @@ export const productScenes: Record<string, () => Promise<any>> = {Broadcasts: () => import('../../products/workflows/frontend/Broadcasts/BroadcastsScene'),Broadcast: () => import('../../products/workflows/frontend/Broadcasts/BroadcastScene'),Transactional: () => import('../../products/workflows/frontend/Transactional/TransactionalScene'),+ TransactionalEmailLogEntry: () =>+ import('../../products/workflows/frontend/Transactional/log/TransactionalEmailLogEntryScene'),WorkflowsEmailDomain: () => import('../../products/workflows/frontend/Channels/EmailDomain/EmailDomainScene'),}diff --git a/frontend/src/products.tsx b/frontend/src/products.tsxindex c2ea23c82d9b..b6d096ca0eab 100644--- a/frontend/src/products.tsx+++ b/frontend/src/products.tsx@@ -403,6 +403,7 @@ export const productRoutes: Record<string, [string, string]> = {'/transactional/settings': ['Transactional', 'transactional'],'/transactional/new': ['Transactional', 'transactional'],'/transactional/log': ['Transactional', 'transactional'],+ '/transactional/log/:id': ['TransactionalEmailLogEntry', 'transactionalEmailLogEntry'],'/transactional/library/templates/:id': ['WorkflowsLibraryTemplate', 'workflowsLibraryTemplate'],'/broadcasts/library/templates/:id': ['WorkflowsLibraryTemplate', 'workflowsLibraryTemplate'],'/broadcasts/new': ['Broadcast', 'broadcast'],@@ -1364,6 +1365,7 @@ export const productConfiguration: Record<string, any> = {projectBased: true,description: 'Send emails from your code with one API call',},+ TransactionalEmailLogEntry: { name: 'Transactional', iconType: 'transactional', projectBased: true },WorkflowsEmailDomain: { name: 'Workflows', iconType: 'workflows', projectBased: true },}@@ -2070,6 +2072,7 @@ export const productUrls = {transactional: (tab?: MessagingNavTabKey): string => `/transactional${tab ? `/${tab}` : ''}`,transactionalNew: (): string => '/transactional/new',transactionalLog: (): string => '/transactional/log',+ transactionalEmailLogEntry: (messageId: string): string => `/transactional/log/${messageId}`,transactionalTemplate: (id: string): string => `/transactional/library/templates/${id}`,broadcastsTemplate: (id: string): string => `/broadcasts/library/templates/${id}`,}@@ -2519,6 +2522,7 @@ export const getTreeItemsProducts = (): FileSystemImport[] => ['Broadcasts','Broadcast','Transactional',+ 'TransactionalEmailLogEntry','WorkflowsEmailDomain',],},@@ -3399,6 +3403,7 @@ export const getTreeItemsProducts = (): FileSystemImport[] => ['Broadcasts','Broadcast','Transactional',+ 'TransactionalEmailLogEntry','WorkflowsEmailDomain',],},@@ -3511,6 +3516,7 @@ export const getTreeItemsProducts = (): FileSystemImport[] => ['Broadcasts','Broadcast','Transactional',+ 'TransactionalEmailLogEntry','WorkflowsEmailDomain',],},diff --git a/frontend/src/scenes/sceneTypes.ts b/frontend/src/scenes/sceneTypes.tsindex c3ddcc75ed37..87d5c231edcc 100644--- a/frontend/src/scenes/sceneTypes.ts+++ b/frontend/src/scenes/sceneTypes.ts@@ -225,6 +225,7 @@ export enum Scene {Workflow = 'Workflow',Broadcasts = 'Broadcasts',Transactional = 'Transactional',+ TransactionalEmailLogEntry = 'TransactionalEmailLogEntry',Workflows = 'Workflows',Broadcast = 'Broadcast',WorkflowsEmailDomain = 'WorkflowsEmailDomain',@@ -462,6 +463,7 @@ export const sceneToAccessControlResourceType: Partial<[Scene.Workflow]: AccessControlResourceType.Workflow,[Scene.Broadcasts]: AccessControlResourceType.Workflow,[Scene.Transactional]: AccessControlResourceType.Workflow,+ [Scene.TransactionalEmailLogEntry]: AccessControlResourceType.Workflow,[Scene.Workflows]: AccessControlResourceType.Workflow,[Scene.Broadcast]: AccessControlResourceType.Workflow,[Scene.WorkflowsEmailDomain]: AccessControlResourceType.Workflow,diff --git a/products/workflows/frontend/Transactional/log/TransactionalEmailDeliveryProgress.stories.tsx b/products/workflows/frontend/Transactional/log/TransactionalEmailDeliveryProgress.stories.tsxnew file mode 100644index 000000000000..02250e8b42d3--- /dev/null+++ b/products/workflows/frontend/Transactional/log/TransactionalEmailDeliveryProgress.stories.tsx@@ -0,0 +1,67 @@+import { Meta, StoryFn } from '@storybook/react'++import type {+ TransactionalEmailLogDetailApi,+ TransactionalEmailLogEventApi,+} from 'products/messaging/frontend/generated/api.schemas'++import { TransactionalEmailDeliveryProgress } from './TransactionalEmailDeliveryProgress'++const meta: Meta<typeof TransactionalEmailDeliveryProgress> = {+ title: 'Scenes-App/Transactional/Email delivery progress',+ component: TransactionalEmailDeliveryProgress,+ parameters: { mockDate: '2026-06-15', testOptions: { snapshotBrowsers: [] } },+}+export default meta++function email(+ status: TransactionalEmailLogDetailApi['status'],+ timeline: TransactionalEmailLogEventApi[]+): TransactionalEmailLogDetailApi {+ return {+ message_id: '01977a3c-9a00-7000-8000-000000000001',+ created_at: '2026-06-15T09:00:00Z',+ status,+ status_at: timeline[timeline.length - 1].at,+ reason: timeline[timeline.length - 1].reason,+ recipient: '[email protected]',+ workflow_id: '01977a3c-9a00-7000-8000-000000000002',+ template_id: '01977a3c-9a00-7000-8000-000000000003',+ template_name: 'Welcome email',+ sending_domain: 'example.com',+ opened: timeline.some((event) => event.kind === 'opened'),+ clicked: timeline.some((event) => event.kind === 'clicked'),+ timeline,+ subject: 'Welcome aboard',+ distinct_id: 'user_1',+ action_id: 'action_1',+ sensitive: false,+ }+}++const Template: StoryFn<typeof TransactionalEmailDeliveryProgress> = (args) => (+ <div className="@container max-w-200 p-4">+ <TransactionalEmailDeliveryProgress {...args} />+ </div>+)++export const OpenedAndClicked = Template.bind({})+OpenedAndClicked.args = {+ email: email('delivered', [+ { kind: 'queued', at: '2026-06-15T09:00:00Z', reason: null },+ { kind: 'sent', at: '2026-06-15T09:00:01Z', reason: null },+ { kind: 'delivered', at: '2026-06-15T09:00:03Z', reason: null },+ { kind: 'opened', at: '2026-06-15T09:12:40Z', reason: null },+ { kind: 'clicked', at: '2026-06-15T09:13:05Z', reason: null },+ { kind: 'opened', at: '2026-06-15T10:02:11Z', reason: null },+ ]),+}++export const Bounced = Template.bind({})+Bounced.args = {+ email: email('bounced', [+ { kind: 'queued', at: '2026-06-15T09:00:00Z', reason: null },+ { kind: 'sent', at: '2026-06-15T09:00:01Z', reason: null },+ { kind: 'bounced', at: '2026-06-15T09:00:04Z', reason: 'hard' },+ ]),+}diff --git a/products/workflows/frontend/Transactional/log/TransactionalEmailDeliveryProgress.tsx b/products/workflows/frontend/Transactional/log/TransactionalEmailDeliveryProgress.tsxnew file mode 100644index 000000000000..c5b2d6a87cf2--- /dev/null+++ b/products/workflows/frontend/Transactional/log/TransactionalEmailDeliveryProgress.tsx@@ -0,0 +1,18 @@+import type { TransactionalEmailLogDetailApi } from 'products/messaging/frontend/generated/api.schemas'++import { buildDeliverySteps } from './emailDeliverySteps'+import { TransactionalEmailDeliveryStep } from './TransactionalEmailDeliveryStep'++export function TransactionalEmailDeliveryProgress({ email }: { email: TransactionalEmailLogDetailApi }): JSX.Element {+ const steps = buildDeliverySteps(email)+ return (+ <ol+ className="flex flex-col @2xl:flex-row gap-3 @2xl:gap-0 m-0 p-4 list-none border rounded bg-surface-primary"+ data-attr="transactional-email-delivery-progress"+ >+ {steps.map((step, index) => (+ <TransactionalEmailDeliveryStep key={step.key} step={step} next={steps[index + 1]} />+ ))}+ </ol>+ )+}diff --git a/products/workflows/frontend/Transactional/log/TransactionalEmailDeliveryStep.tsx b/products/workflows/frontend/Transactional/log/TransactionalEmailDeliveryStep.tsxnew file mode 100644index 000000000000..c97252c24222--- /dev/null+++ b/products/workflows/frontend/Transactional/log/TransactionalEmailDeliveryStep.tsx@@ -0,0 +1,75 @@+import clsx from 'clsx'++import { IconCheck, IconX } from '@posthog/icons'+import { Tooltip } from '@posthog/lemon-ui'++import { TZLabel } from 'lib/components/TZLabel'++import { DeliveryStep, gapLabel } from './emailDeliverySteps'++/** One step of the delivery progress, and the line that leads to the next step. */+export function TransactionalEmailDeliveryStep({+ step,+ next,+}: {+ step: DeliveryStep+ next: DeliveryStep | undefined+}): JSX.Element {+ const gap = step.at ? gapLabel(step.at, step.previousAt) : null+ return (+ <li className="flex @2xl:flex-col gap-3 @2xl:gap-2 flex-1 min-w-0">+ <div className="flex items-center @2xl:w-full">+ <span+ className={clsx(+ 'flex items-center justify-center size-6 rounded-full shrink-0 border',+ step.state === 'done' && 'bg-success border-success text-white',+ step.state === 'failed' && 'bg-danger border-danger text-white',+ step.state === 'pending' && 'bg-surface-primary border-dashed border-border-bold'+ )}+ >+ {step.state === 'done' && <IconCheck className="size-4" />}+ {step.state === 'failed' && <IconX className="size-4" />}+ </span>+ {next && (+ <span+ className={clsx(+ 'hidden @2xl:block h-px flex-1 mx-2',+ next.state === 'pending' ? 'bg-border' : 'bg-border-bold'+ )}+ />+ )}+ </div>+ <div className="flex flex-col min-w-0 @2xl:pr-4">+ <span+ className={clsx(+ 'text-sm font-semibold',+ step.state === 'pending' && 'text-secondary',+ step.state === 'failed' && 'text-danger'+ )}+ >+ {step.label}+ </span>+ {step.at ? (+ <span className="text-xs text-secondary flex flex-wrap gap-x-1">+ <TZLabel time={step.at} formatDate="MMM D" formatTime="HH:mm:ss" />+ {gap && <span>· {gap}</span>}+ </span>+ ) : (+ step.state === 'pending' && (+ <span className="text-xs text-secondary">+ {step.key === 'opened' || step.key === 'clicked' ? 'Not yet' : 'Waiting'}+ </span>+ )+ )}+ {step.detail &&+ (step.detail.length > 40 ? (+ <Tooltip title={step.detail}>+ <span className="text-xs text-secondary truncate">{step.detail}</span>+ </Tooltip>+ ) : (+ <span className="text-xs text-secondary">{step.detail}</span>+ ))}+ </div>+ </li>+ )+}diff --git a/products/workflows/frontend/Transactional/log/TransactionalEmailDetails.tsx b/products/workflows/frontend/Transactional/log/TransactionalEmailDetails.tsxnew file mode 100644index 000000000000..97b44dafdb9a--- /dev/null+++ b/products/workflows/frontend/Transactional/log/TransactionalEmailDetails.tsx@@ -0,0 +1,79 @@+import { LemonTag, Link, Tooltip } from '@posthog/lemon-ui'++import { CopyToClipboardInline } from 'lib/components/CopyToClipboard'+import { TZLabel } from 'lib/components/TZLabel'+import { urls } from 'scenes/urls'++import type { TransactionalEmailLogDetailApi } from 'products/messaging/frontend/generated/api.schemas'++import { EMAIL_STATUS_DESCRIPTION, EMAIL_STATUS_LABEL, EMAIL_STATUS_TAG } from './emailLogStatus'++function DetailRow({+ label,+ stacked = false,+ children,+}: {+ label: string+ /** Puts the value under the label, for long values such as IDs. */+ stacked?: boolean+ children: React.ReactNode+}): JSX.Element {+ return (+ <div+ className={+ stacked ? 'flex flex-col gap-0.5 text-sm' : 'flex justify-between items-baseline gap-4 text-sm min-w-0'+ }+ >+ <dt className="text-secondary shrink-0">{label}</dt>+ <dd className={stacked ? 'm-0' : 'm-0 min-w-0 text-right truncate'}>{children}</dd>+ </div>+ )+}++export function TransactionalEmailDetails({ email }: { email: TransactionalEmailLogDetailApi }): JSX.Element {+ return (+ <section className="border rounded bg-surface-primary p-4 flex flex-col gap-3">+ <h3 className="text-sm font-semibold m-0">Details</h3>+ <dl className="flex flex-col gap-2 m-0">+ <DetailRow label="Status">+ <Tooltip title={EMAIL_STATUS_DESCRIPTION[email.status]}>+ <LemonTag type={EMAIL_STATUS_TAG[email.status]}>{EMAIL_STATUS_LABEL[email.status]}</LemonTag>+ </Tooltip>+ </DetailRow>+ <DetailRow label="Email">+ {email.template_id ? (+ <Link to={urls.transactionalTemplate(email.template_id)}>+ {email.template_name || 'Unnamed email'}+ </Link>+ ) : email.template_name ? (+ email.template_name+ ) : (+ <span className="text-secondary">Deleted email</span>+ )}+ </DetailRow>+ <DetailRow label="Queued">+ <TZLabel time={email.created_at} />+ </DetailRow>+ {email.sending_domain && <DetailRow label="Sending domain">{email.sending_domain}</DetailRow>}+ {email.distinct_id && (+ <DetailRow label="Distinct ID" stacked>+ <span className="ph-no-capture">+ <CopyToClipboardInline+ description="distinct ID"+ explicitValue={email.distinct_id}+ iconSize="xsmall"+ >+ <span className="font-mono text-xs">{email.distinct_id}</span>+ </CopyToClipboardInline>+ </span>+ </DetailRow>+ )}+ <DetailRow label="Message ID" stacked>+ <CopyToClipboardInline description="message ID" explicitValue={email.message_id} iconSize="xsmall">+ <span className="font-mono text-xs">{email.message_id}</span>+ </CopyToClipboardInline>+ </DetailRow>+ </dl>+ </section>+ )+}diff --git a/products/workflows/frontend/Transactional/log/TransactionalEmailLog.tsx b/products/workflows/frontend/Transactional/log/TransactionalEmailLog.tsxindex d8c2a2c7ec98..124150d22047 100644--- a/products/workflows/frontend/Transactional/log/TransactionalEmailLog.tsx+++ b/products/workflows/frontend/Transactional/log/TransactionalEmailLog.tsx@@ -1,4 +1,5 @@import { useActions, useValues } from 'kea'+import { router } from 'kea-router'import { IconCursorClick, IconEye, IconRefresh, IconSearch } from '@posthog/icons'import { LemonBanner, LemonButton, LemonInput, LemonSelect, LemonTag, Tooltip } from '@posthog/lemon-ui'@@ -6,7 +7,9 @@ import { LemonBanner, LemonButton, LemonInput, LemonSelect, LemonTag, Tooltip }import { DateFilter } from 'lib/components/DateFilter/DateFilter'import { TZLabel } from 'lib/components/TZLabel'import { LemonTable } from 'lib/lemon-ui/LemonTable'+import { LemonTableLink } from 'lib/lemon-ui/LemonTable/LemonTableLink'import { INVOCATIONS_DATE_OPTIONS } from 'scenes/hog-functions/invocations/invocationsDateOptions'+import { urls } from 'scenes/urls'import type { TransactionalEmailLogEntryApi } from 'products/messaging/frontend/generated/api.schemas'@@ -135,14 +138,21 @@ export function TransactionalEmailLog(): JSX.Element {}}nouns={['send', 'sends']}data-attr="transactional-email-log-table"+ onRow={(email) => ({+ onClick: () => router.actions.push(urls.transactionalEmailLogEntry(email.message_id)),+ className: 'cursor-pointer',+ })}columns={[{title: 'Recipient',key: 'recipient',render: (_, email) => (- <span className="ph-no-capture">- <EmailAddress address={email.recipient} />- </span>+ <LemonTableLink+ to={urls.transactionalEmailLogEntry(email.message_id)}+ title={<EmailAddress address={email.recipient} />}+ className="ph-no-capture"+ onClick={(event) => event.stopPropagation()}+ />),},{diff --git a/products/workflows/frontend/Transactional/log/TransactionalEmailLogEntryScene.tsx b/products/workflows/frontend/Transactional/log/TransactionalEmailLogEntryScene.tsxnew file mode 100644index 000000000000..7f8e98fe99e5--- /dev/null+++ b/products/workflows/frontend/Transactional/log/TransactionalEmailLogEntryScene.tsx@@ -0,0 +1,107 @@+import { useActions, useValues } from 'kea'++import { LemonBanner, LemonButton, LemonSkeleton } from '@posthog/lemon-ui'++import { NotFound } from 'lib/components/NotFound'+import { useFeatureFlag } from 'lib/hooks/useFeatureFlag'+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 { TransactionalEmailDeliveryProgress } from './TransactionalEmailDeliveryProgress'+import { TransactionalEmailDetails } from './TransactionalEmailDetails'+import {+ TransactionalEmailLogEntryLogicProps,+ transactionalEmailLogEntryLogic,+} from './transactionalEmailLogEntryLogic'+import { TransactionalEmailPersonCard } from './TransactionalEmailPersonCard'+import { TransactionalEmailRendered } from './TransactionalEmailRendered'++export const scene: SceneExport<TransactionalEmailLogEntryLogicProps> = {+ component: TransactionalEmailLogEntryScene,+ logic: transactionalEmailLogEntryLogic,+ paramsToProps: ({ params: { id } }): TransactionalEmailLogEntryLogicProps => ({ messageId: id }),+ productKey: ProductKey.WORKFLOWS,+}++export function TransactionalEmailLogEntryScene(): JSX.Element {+ const showTransactional = useFeatureFlag('WORKFLOWS_TRANSACTIONAL_EMAIL_API')+ // The scene binds the logic to the message ID in the URL.+ const { email, emailLoading, emailFailed } = useValues(transactionalEmailLogEntryLogic)+ const { loadEmail } = useActions(transactionalEmailLogEntryLogic)++ if (!showTransactional) {+ return <NotFound object="page" />+ }+ if (emailFailed && !emailLoading) {+ return (+ <SceneContent>+ <LemonBanner+ type="error"+ action={{+ children: 'Try again',+ onClick: () => loadEmail(),+ 'data-attr': 'transactional-email-log-entry-retry',+ }}+ >+ This email couldn't load. Check your connection and try again.+ </LemonBanner>+ </SceneContent>+ )+ }+ if (email === null && !emailLoading) {+ return (+ <NotFound+ object="email"+ caption="No send of this project has this message ID, or it is older than 30 days."+ />+ )+ }++ return (+ <SceneContent>+ <div className="ph-no-capture contents">+ <SceneTitleSection+ name={email?.recipient || 'Email'}+ description={email ? email.subject || email.template_name || null : null}+ resourceType={{ type: 'transactional' }}+ isLoading={!email}+ actions={+ email?.template_id ? (+ <LemonButton+ type="secondary"+ size="small"+ to={urls.transactionalTemplate(email.template_id)}+ data-attr="transactional-email-log-entry-open-template"+ >+ Open email+ </LemonButton>+ ) : undefined+ }+ />+ </div>+ {!email ? (+ <div className="flex flex-col gap-4">+ <LemonSkeleton className="h-20" />+ <LemonSkeleton className="h-100" />+ </div>+ ) : (+ <div className="@container flex flex-col gap-4">+ <TransactionalEmailDeliveryProgress email={email} />+ <div className="flex flex-col @3xl:flex-row gap-4 items-start">+ <div className="w-full @3xl:flex-1 min-w-0 flex flex-col gap-4 order-last @3xl:order-none">+ <TransactionalEmailRendered email={email} />+ </div>+ <div className="w-full @3xl:w-80 shrink-0 flex flex-col gap-4">+ {email.distinct_id && <TransactionalEmailPersonCard distinctId={email.distinct_id} />}+ <TransactionalEmailDetails email={email} />+ </div>+ </div>+ </div>+ )}+ </SceneContent>+ )+}diff --git a/products/workflows/frontend/Transactional/log/TransactionalEmailPersonCard.tsx b/products/workflows/frontend/Transactional/log/TransactionalEmailPersonCard.tsxnew file mode 100644index 000000000000..a91014f96972--- /dev/null+++ b/products/workflows/frontend/Transactional/log/TransactionalEmailPersonCard.tsx@@ -0,0 +1,118 @@+import { useActions, useValues } from 'kea'++import { LemonButton, LemonSkeleton, ProfilePicture } from '@posthog/lemon-ui'++import { TZLabel } from 'lib/components/TZLabel'+import { urls } from 'scenes/urls'++import { asDisplay } from 'products/persons/frontend/person-utils'++import { transactionalEmailLogEntryLogic } from './transactionalEmailLogEntryLogic'++function PropertyRow({ label, children }: { label: string; children: React.ReactNode }): JSX.Element {+ return (+ <div className="flex justify-between gap-4 text-sm min-w-0">+ <dt className="text-secondary shrink-0">{label}</dt>+ <dd className="m-0 text-right truncate min-w-0">{children}</dd>+ </div>+ )+}++function location(properties: Record<string, any>): string | null {+ const parts = [properties.$geoip_city_name, properties.$geoip_country_name].filter(Boolean)+ return parts.length ? parts.join(', ') : null+}++export function TransactionalEmailPersonCard({ distinctId }: { distinctId: string }): JSX.Element {+ const { person, personLoading, personFailed } = useValues(transactionalEmailLogEntryLogic)+ const { loadPerson } = useActions(transactionalEmailLogEntryLogic)++ if (personFailed && !personLoading) {+ return (+ <div className="border rounded bg-surface-primary p-4 flex flex-col gap-2">+ <h3 className="text-sm font-semibold m-0">Person</h3>+ <p className="text-sm text-secondary m-0">+ This person couldn't load. Check your connection and try again.+ </p>+ <div>+ <LemonButton+ type="secondary"+ size="small"+ onClick={() => loadPerson(distinctId)}+ data-attr="transactional-email-person-card-retry"+ >+ Try again+ </LemonButton>+ </div>+ </div>+ )+ }++ if (person === undefined || personLoading) {+ return (+ <div className="border rounded bg-surface-primary p-4 flex flex-col gap-3">+ <div className="flex items-center gap-3">+ <LemonSkeleton.Circle className="size-10" />+ <div className="flex flex-col gap-2 flex-1">+ <LemonSkeleton className="h-4 w-3/4" />+ <LemonSkeleton className="h-3 w-1/2" />+ </div>+ </div>+ <LemonSkeleton className="h-16" />+ </div>+ )+ }++ if (person === null) {+ return (+ <div className="ph-no-capture border rounded bg-surface-primary p-4 flex flex-col gap-2">+ <h3 className="text-sm font-semibold m-0">Person</h3>+ <p className="text-sm text-secondary m-0">+ No person in this project has the distinct ID <code className="break-all">{distinctId}</code> yet.+ They show up here once your app captures an event for them.+ </p>+ </div>+ )+ }++ const { properties } = person+ const email = typeof properties.email === 'string' ? properties.email : null+ const name =+ typeof properties.name === 'string' && properties.name.trim()+ ? properties.name+ : asDisplay({ id: person.id, distinct_id: distinctId, properties })+ const place = location(properties)+ const plan = typeof properties.plan === 'string' ? properties.plan : null++ return (+ <div+ className="ph-no-capture border rounded bg-surface-primary p-4 flex flex-col gap-4"+ data-attr="transactional-email-person"+ >+ <div className="flex items-center gap-3 min-w-0">+ <ProfilePicture user={{ first_name: name, email: email ?? undefined }} size="xl" />+ <div className="flex flex-col min-w-0">+ <span className="font-semibold truncate">{name}</span>+ {email && email !== name && <span className="text-xs text-secondary truncate">{email}</span>}+ </div>+ </div>+ <dl className="flex flex-col gap-2 m-0">+ {plan && <PropertyRow label="Plan">{plan}</PropertyRow>}+ {place && <PropertyRow label="Location">{place}</PropertyRow>}+ <PropertyRow label="First seen">+ <TZLabel time={person.createdAt} />+ </PropertyRow>+ </dl>+ <LemonButton+ type="secondary"+ size="small"+ fullWidth+ center+ to={urls.personByUUID(person.id)}+ data-attr="transactional-email-log-person"+ >+ View person+ </LemonButton>+ </div>+ )+}diff --git a/products/workflows/frontend/Transactional/log/TransactionalEmailRendered.tsx b/products/workflows/frontend/Transactional/log/TransactionalEmailRendered.tsxnew file mode 100644index 000000000000..649b24add8bc--- /dev/null+++ b/products/workflows/frontend/Transactional/log/TransactionalEmailRendered.tsx@@ -0,0 +1,44 @@+import { IconLock } from '@posthog/icons'+import { LemonBanner } from '@posthog/lemon-ui'++import type { TransactionalEmailLogDetailApi } from 'products/messaging/frontend/generated/api.schemas'++import { getMessageAssetContentUrl } from '../../Workflows/messageAssetsApi'++export function TransactionalEmailRendered({ email }: { email: TransactionalEmailLogDetailApi }): JSX.Element {+ if (email.sensitive) {+ return (+ <LemonBanner type="info" icon={<IconLock />}>+ This email is marked sensitive, so PostHog keeps no copy of what it contained.+ </LemonBanner>+ )+ }+ if (!email.action_id) {+ return (+ <LemonBanner type="info">+ {email.status === 'queued'+ ? "This email hasn't gone out yet, so there's no copy of it."+ : email.status === 'failed'+ ? "This email wasn't sent, so there's no copy of it."+ : 'No copy of this email was kept.'}+ </LemonBanner>+ )+ }+ return (+ <section className="border rounded bg-surface-primary overflow-hidden">+ <dl className="ph-no-capture m-0 px-4 py-3 border-b grid grid-cols-[auto_1fr] gap-x-4 gap-y-1 text-sm">+ <dt className="text-secondary">To</dt>+ <dd className="m-0 truncate">{email.recipient}</dd>+ <dt className="text-secondary">Subject</dt>+ <dd className="m-0 font-semibold truncate">{email.subject || '(no subject)'}</dd>+ </dl>+ {/* sandbox="" disables scripts so the captured email HTML can't run anything. */}+ <iframe+ title="Rendered email"+ sandbox=""+ src={getMessageAssetContentUrl(email.workflow_id, email.message_id, email.action_id)}+ className="w-full h-[70vh] bg-white block"+ />+ </section>+ )+}diff --git a/products/workflows/frontend/Transactional/log/emailActivity.ts b/products/workflows/frontend/Transactional/log/emailActivity.tsnew file mode 100644index 000000000000..527167d24e85--- /dev/null+++ b/products/workflows/frontend/Transactional/log/emailActivity.ts@@ -0,0 +1,5 @@+export interface ActivityPerson {+ id: string+ properties: Record<string, any>+ createdAt: string+}diff --git a/products/workflows/frontend/Transactional/log/emailActivityQueries.ts b/products/workflows/frontend/Transactional/log/emailActivityQueries.tsnew file mode 100644index 000000000000..377dbaa352bc--- /dev/null+++ b/products/workflows/frontend/Transactional/log/emailActivityQueries.ts@@ -0,0 +1,26 @@+import api from 'lib/api'+import { hogql } from 'lib/utils/hogql'++import { ActivityPerson } from './emailActivity'++const QUERY_TAGS = { productKey: 'workflows', scene: 'TransactionalEmailLogEntry' }++export async function fetchActivityPerson(distinctId: string): Promise<ActivityPerson | null> {+ const response = await api.queryHogQL(+ hogql`SELECT id, properties, created_at+FROM persons+WHERE id IN (SELECT person_id FROM person_distinct_ids WHERE distinct_id = ${distinctId})+LIMIT 1`,+ QUERY_TAGS+ )+ const row = response.results?.[0]+ if (!row) {+ return null+ }+ const [id, properties, createdAt] = row+ return {+ id,+ properties: typeof properties === 'string' ? JSON.parse(properties) : (properties ?? {}),+ createdAt,+ }+}diff --git a/products/workflows/frontend/Transactional/log/emailDeliverySteps.test.ts b/products/workflows/frontend/Transactional/log/emailDeliverySteps.test.tsnew file mode 100644index 000000000000..a71cb4059c1f--- /dev/null+++ b/products/workflows/frontend/Transactional/log/emailDeliverySteps.test.ts@@ -0,0 +1,76 @@+import type {+ TransactionalEmailLogDetailApi,+ TransactionalEmailLogEventApi,+} from 'products/messaging/frontend/generated/api.schemas'++import { buildDeliverySteps } from './emailDeliverySteps'++function email(+ status: TransactionalEmailLogDetailApi['status'],+ kinds: TransactionalEmailLogEventApi['kind'][]+): TransactionalEmailLogDetailApi {+ return {+ message_id: '01977a3c-9a00-7000-8000-000000000001',+ created_at: '2026-06-15T09:00:00Z',+ status,+ status_at: '2026-06-15T09:00:00Z',+ reason: null,+ recipient: '[email protected]',+ workflow_id: 'workflow',+ template_id: 'template',+ template_name: 'Welcome email',+ sending_domain: 'example.com',+ opened: kinds.includes('opened'),+ clicked: kinds.includes('clicked'),+ timeline: kinds.map((kind, index) => ({+ kind,+ at: `2026-06-15T09:00:0${index}Z`,+ reason: kind === 'bounced' ? 'hard' : null,+ })),+ subject: 'Welcome',+ distinct_id: 'user_1',+ action_id: 'action_1',+ sensitive: false,+ }+}++describe('buildDeliverySteps', () => {+ test.each([+ [+ 'opened and clicked',+ email('delivered', ['queued', 'sent', 'delivered', 'opened', 'clicked']),+ ['sent:done', 'delivered:done', 'opened:done', 'clicked:done'],+ ],+ [+ 'delivered, not opened yet',+ email('delivered', ['queued', 'sent', 'delivered']),+ ['sent:done', 'delivered:done', 'opened:pending', 'clicked:pending'],+ ],+ [+ 'still queued',+ email('queued', ['queued']),+ ['queued:done', 'sent:pending', 'delivered:pending', 'opened:pending', 'clicked:pending'],+ ],+ ['bounce stops the steps', email('bounced', ['queued', 'sent', 'bounced']), ['sent:done', 'bounced:failed']],+ [+ 'spam report stops the steps',+ email('complained', ['queued', 'sent', 'delivered', 'complained', 'opened']),+ ['sent:done', 'delivered:done', 'complained:failed'],+ ],+ ['failed', email('failed', ['queued', 'failed']), ['queued:done', 'failed:failed']],+ ['rejected after it was sent', email('failed', ['queued', 'sent', 'failed']), ['sent:done', 'failed:failed']],+ [+ 'sent row arriving after delivered',+ email('delivered', ['queued', 'delivered', 'sent']),+ ['sent:done', 'delivered:done', 'opened:pending', 'clicked:pending'],+ ],+ ])('%s', (_, input, expected) => {+ expect(buildDeliverySteps(input).map((step) => `${step.key}:${step.state}`)).toEqual(expected)+ })++ test('a bounce after a failed attempt shows when it bounced, not when the attempt failed', () => {+ const steps = buildDeliverySteps(email('bounced', ['queued', 'failed', 'sent', 'bounced']))++ expect(steps[steps.length - 1]).toMatchObject({ key: 'bounced', at: '2026-06-15T09:00:03Z' })+ })+})diff --git a/products/workflows/frontend/Transactional/log/emailDeliverySteps.ts b/products/workflows/frontend/Transactional/log/emailDeliverySteps.tsnew file mode 100644index 000000000000..dad6072cdd86--- /dev/null+++ b/products/workflows/frontend/Transactional/log/emailDeliverySteps.ts@@ -0,0 +1,119 @@+import { dayjs } from 'lib/dayjs'+import { humanFriendlyDuration } from 'lib/utils/durations'++import type {+ EmailLogEventKindEnumApi,+ TransactionalEmailLogDetailApi,+ TransactionalEmailLogEventApi,+} from 'products/messaging/frontend/generated/api.schemas'++import { EMAIL_STATUS_LABEL, emailReasonText } from './emailLogStatus'++export type DeliveryStepState = 'done' | 'failed' | 'pending'++export interface DeliveryStep {+ key: string+ label: string+ state: DeliveryStepState+ at: string | null+ detail: string | null+ previousAt: string | null+}++function firstOf(+ timeline: readonly TransactionalEmailLogEventApi[],+ kind: EmailLogEventKindEnumApi+): TransactionalEmailLogEventApi | undefined {+ return timeline.find((event) => event.kind === kind)+}++function countOf(timeline: readonly TransactionalEmailLogEventApi[], kind: EmailLogEventKindEnumApi): number {+ return timeline.filter((event) => event.kind === kind).length+}++function step(+ key: string,+ label: string,+ event: { at: string } | undefined,+ previousAt: string | null,+ detail: string | null = null+): DeliveryStep {+ return { key, label, state: event ? 'done' : 'pending', at: event?.at ?? null, detail, previousAt }+}++function repeated(count: number, verb: string): string | null {+ return count > 1 ? `${verb} ${count} times` : null+}++/** The steps an email went through, ending where it stopped. */+export function buildDeliverySteps(email: TransactionalEmailLogDetailApi): DeliveryStep[] {+ const { timeline } = email+ const sent = firstOf(timeline, 'sent')+ const delivered = firstOf(timeline, 'delivered')+ const opened = firstOf(timeline, 'opened')+ // A rerun can fail and then bounce, so the last step reads from the row behind the final status.+ const failure = firstOf(timeline, email.status)+ const queuedAt = firstOf(timeline, 'queued')?.at ?? email.created_at+ const stopped = (+ kind: 'failed' | 'bounced' | 'complained',+ previousAt: string | null,+ detail: string | null+ ): DeliveryStep => ({+ key: kind,+ label: EMAIL_STATUS_LABEL[kind],+ state: 'failed',+ at: failure?.at ?? null,+ detail,+ previousAt,+ })+ const reason = emailReasonText(failure?.reason ?? email.reason)+ const queuedStep = step('queued', 'Queued', { at: queuedAt }, null)++ if (email.status === 'failed') {+ // The provider can reject an email after it accepted the send.+ return sent+ ? [step('sent', 'Sent', sent, null), stopped('failed', sent.at, reason)]+ : [queuedStep, stopped('failed', queuedAt, reason)]+ }+ // A send that went out shows Sent as its first step. Queued only matters while it waits.+ const lead = sent ? [] : [queuedStep]+ const sentStep = step('sent', 'Sent', sent, lead.length ? queuedAt : null)+ if (email.status === 'bounced') {+ return [...lead, sentStep, stopped('bounced', sent?.at ?? null, reason)]+ }+ // A spam report proves the email arrived, even when the delivery update has not.+ const deliveredStep = step('delivered', 'Delivered', delivered, sent?.at ?? null)+ if (email.status === 'complained') {+ return [+ ...lead,+ sentStep,+ { ...deliveredStep, state: 'done' },+ stopped('complained', delivered?.at ?? sent?.at ?? null, 'The recipient reported this email as spam'),+ ]+ }+ return [+ ...lead,+ sentStep,+ deliveredStep,+ step('opened', 'Opened', opened, delivered?.at ?? null, repeated(countOf(timeline, 'opened'), 'Opened')),+ step(+ 'clicked',+ 'Clicked',+ firstOf(timeline, 'clicked'),+ opened?.at ?? delivered?.at ?? null,+ repeated(countOf(timeline, 'clicked'), 'Clicked')+ ),+ ]+}++/** "3s later", for the time between a step and the one before it. */+export function gapLabel(at: string, previousAt: string | null): string | null {+ if (!previousAt) {+ return null+ }+ const seconds = dayjs(at).diff(dayjs(previousAt), 'second')+ if (seconds < 1) {+ return 'under a second later'+ }+ return `${humanFriendlyDuration(seconds, { maxUnits: 1 })} later`+}diff --git a/products/workflows/frontend/Transactional/log/transactionalEmailLogEntryLogic.ts b/products/workflows/frontend/Transactional/log/transactionalEmailLogEntryLogic.tsnew file mode 100644index 000000000000..1c324a1b8298--- /dev/null+++ b/products/workflows/frontend/Transactional/log/transactionalEmailLogEntryLogic.ts@@ -0,0 +1,176 @@+import { MakeLogicType, afterMount, connect, kea, key, listeners, path, props, reducers, selectors } from 'kea'+import { loaders } from 'kea-loaders'+import posthog from 'posthog-js'++import { projectLogic } from 'scenes/projectLogic'+import { Scene } from 'scenes/sceneTypes'+import { urls } from 'scenes/urls'++import { Breadcrumb } from '~/types'++import { transactionalEmailLogRetrieve } from 'products/messaging/frontend/generated/api'+import type { TransactionalEmailLogDetailApi } from 'products/messaging/frontend/generated/api.schemas'++import { ActivityPerson } from './emailActivity'+import { fetchActivityPerson } from './emailActivityQueries'++export interface TransactionalEmailLogEntryLogicProps {+ messageId: string+}++// Generated by kea-typegen. Update if you're an agent, ignore if you're human.+export interface transactionalEmailLogEntryLogicValues {+ currentProjectId: number | null // projectLogic+ breadcrumbs: Breadcrumb[]+ email: TransactionalEmailLogDetailApi | null | undefined+ emailFailed: boolean+ emailLoading: boolean+ person: ActivityPerson | null | undefined+ personFailed: boolean+ personLoading: boolean+}++// Generated by kea-typegen. Update if you're an agent, ignore if you're human.+export interface transactionalEmailLogEntryLogicActions {+ loadEmail: () => any+ loadEmailFailure: (+ error: string,+ errorObject?: any+ ) => {+ error: string+ errorObject?: any+ }+ loadEmailSuccess: (+ email: TransactionalEmailLogDetailApi | null,+ payload?: any+ ) => {+ email: TransactionalEmailLogDetailApi | null+ payload?: any+ }+ loadPerson: (distinctId: string) => string+ loadPersonFailure: (+ error: string,+ errorObject?: any+ ) => {+ error: string+ errorObject?: any+ }+ loadPersonSuccess: (+ person: ActivityPerson | null,+ payload?: string+ ) => {+ person: ActivityPerson | null+ payload?: string+ }+}++// Generated by kea-typegen. Update if you're an agent, ignore if you're human.+export interface transactionalEmailLogEntryLogicMeta {+ key: string+ __keaTypeGenInternalSelectorTypes: {+ breadcrumbs: (messageId: string) => Breadcrumb[]+ }+}++export type transactionalEmailLogEntryLogicType = MakeLogicType<+ transactionalEmailLogEntryLogicValues,+ transactionalEmailLogEntryLogicActions,+ TransactionalEmailLogEntryLogicProps,+ transactionalEmailLogEntryLogicMeta+>++export const transactionalEmailLogEntryLogic = kea<transactionalEmailLogEntryLogicType>([+ props({} as TransactionalEmailLogEntryLogicProps),+ key((props) => props.messageId),+ path((key) => [+ 'products',+ 'workflows',+ 'frontend',+ 'Transactional',+ 'log',+ 'transactionalEmailLogEntryLogic',+ key,+ ]),+ connect(() => ({ values: [projectLogic, ['currentProjectId']] })),+ reducers({+ personFailed: [+ false,+ {+ loadPerson: () => false,+ loadPersonSuccess: () => false,+ loadPersonFailure: () => true,+ },+ ],+ emailFailed: [+ false,+ {+ loadEmail: () => false,+ loadEmailSuccess: () => false,+ loadEmailFailure: () => true,+ },+ ],+ }),+ loaders(({ props, values }) => ({+ // undefined until the first load answers, null when the project has no send with this ID.+ email: [+ undefined as TransactionalEmailLogDetailApi | null | undefined,+ {+ loadEmail: async () => {+ if (values.currentProjectId === null) {+ return null+ }+ try {+ return await transactionalEmailLogRetrieve(String(values.currentProjectId), props.messageId)+ } catch (error: any) {+ if (error?.status === 404) {+ return null+ }+ throw error+ }+ },+ },+ ],+ // undefined until the lookup answers, null when no person has the send's distinct ID.+ person: [+ undefined as ActivityPerson | null | undefined,+ {+ loadPerson: async (distinctId: string) => await fetchActivityPerson(distinctId),+ },+ ],+ })),+ selectors({+ breadcrumbs: [+ (_, p) => [p.messageId],+ (messageId: string): Breadcrumb[] => [+ {+ key: Scene.Transactional,+ name: 'Transactional',+ path: urls.transactional(),+ iconType: 'transactional',+ },+ { key: 'log', name: 'Log', path: urls.transactionalLog(), iconType: 'transactional' },+ {+ key: [Scene.TransactionalEmailLogEntry, messageId],+ // The page title comes from this name, and analytics record the page title.+ name: 'Email',+ iconType: 'transactional',+ },+ ],+ ],+ }),+ listeners(({ actions }) => ({+ loadEmailSuccess: ({ email }) => {+ if (email?.distinct_id) {+ actions.loadPerson(email.distinct_id)+ }+ // pinned: analytics event name - renaming breaks dashboards+ posthog.capture('transactional email log entry viewed', {+ found: !!email,+ status: email?.status,+ opened: email?.opened,+ clicked: email?.clicked,+ })+ },+ })),+ afterMount(({ actions }) => actions.loadEmail()),+])diff --git a/products/workflows/manifest.tsx b/products/workflows/manifest.tsxindex 955d4a39455d..e422dff7d134 100644--- a/products/workflows/manifest.tsx+++ b/products/workflows/manifest.tsx@@ -57,6 +57,12 @@ export const manifest: ProductManifest = {projectBased: true,description: 'Send emails from your code with one API call',},+ TransactionalEmailLogEntry: {+ import: () => import('./frontend/Transactional/log/TransactionalEmailLogEntryScene'),+ name: 'Transactional',+ iconType: 'transactional',+ projectBased: true,+ },WorkflowsEmailDomain: {import: () => import('./frontend/Channels/EmailDomain/EmailDomainScene'),name: 'Workflows',@@ -94,6 +100,7 @@ export const manifest: ProductManifest = {'/transactional/settings': ['Transactional', 'transactional'],'/transactional/new': ['Transactional', 'transactional'],'/transactional/log': ['Transactional', 'transactional'],+ '/transactional/log/:id': ['TransactionalEmailLogEntry', 'transactionalEmailLogEntry'],// 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'],@@ -117,6 +124,7 @@ export const manifest: ProductManifest = {transactional: (tab?: MessagingNavTabKey): string => `/transactional${tab ? `/${tab}` : ''}`,transactionalNew: (): string => '/transactional/new',transactionalLog: (): string => '/transactional/log',+ transactionalEmailLogEntry: (messageId: string): string => `/transactional/log/${messageId}`,transactionalTemplate: (id: string): string => `/transactional/library/templates/${id}`,broadcastsTemplate: (id: string): string => `/broadcasts/library/templates/${id}`,},diff --git a/services/mcp/src/tools/links/app-url-manifest.json b/services/mcp/src/tools/links/app-url-manifest.jsonindex 1c7c27229d20..1058171b22b0 100644--- a/services/mcp/src/tools/links/app-url-manifest.json+++ b/services/mcp/src/tools/links/app-url-manifest.json@@ -1854,6 +1854,11 @@"params": [],"scope": "project"},+ "transactionalEmailLogEntry": {+ "template": "/transactional/log/{messageId}",+ "params": ["messageId"],+ "scope": "project"+ },"transactionalLog": {"template": "/transactional/log","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 edd47b3767ca..442e37fcf804 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/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/device\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/slack/{integrationId}/setup\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/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/transactional/log\n/transactional/new\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}\n/workload-trust-policy-requests/{id}",+ "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/device\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/slack/{integrationId}/setup\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/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/transactional/log\n/transactional/log/{messageId}\n/transactional/new\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}\n/workload-trust-policy-requests/{id}","type": "string"}},