PostHog
Every ingested app and server event, mirrored to your PostHog project in real time — same users, same names, no second SDK in your app.
Connect PostHog and Fictura forwards each accepted ingest batch — everything that arrives through POST /api/v1/events/log, from the SDK or your server — to PostHog's batch endpoint as it lands. Your app keeps one SDK; PostHog gets the same stream. Events Fictura mints from billing webhooks (trial_started, subscription_renewed…) are forwarded too, with properties.fictura_billing_type set. A historical import is not mirrored.
- Identity —
distinct_idis the user's ownaccount_idwhen the event has one, so it joins the events you already send PostHog; otherwise it is Fictura'smaster_user_id. Every event also setsfictura_master_user_idon the person. - Provenance — every forwarded event carries
properties.source = "fictura", so you can tell the mirror from anything you send PostHog directly. - Delivery — through an outbox after ingestion: tried at once, then retried with backoff, 5 tries in all. Each event carries a stable
uuid, so a retried batch does not double. Mirroring can never slow down or fail your app's event write. - Host — defaults to
https://us.i.posthog.com; EU or self-hosted projects set their own host when connecting. - Filter — by default everything goes.
PUT /api/v1/integrations/posthog/mirror(dashboard session) takesinclude_eventsandexclude_events: exact names or a prefix ending in*. Exclude wins. The dashboard has no field for this.
Set it up
Dashboard → Tools → PostHog Export → Connect.
Paste your project API key (and host, if not US cloud). The key is verified before it's stored, encrypted at rest, and never returned.
Look for the handshake event.
Verification sends a single growth_agent_connected event to your project — when you can see it in PostHog, the mirror is live.
Events disabled in capture control are dropped before forwarding, so the kill switch governs the mirror too.