Skip to content

: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.

feat(workflows): add the transactional email page (#129260)

Daniel Marchuk1cfa2bb4a9a7
diff --git a/frontend/src/productScenes.tsx b/frontend/src/productScenes.tsx
index 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.tsx
index 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.ts
index 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.tsx
new file mode 100644
index 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.tsx
new file mode 100644
index 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.tsx
new file mode 100644
index 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.tsx
new file mode 100644
index 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.tsx
index 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.tsx
new file mode 100644
index 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.tsx
new file mode 100644
index 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.tsx
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.tsx
index 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.json
index 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.json
index 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"
}
},