Linking Tavus as a source
The Tavus source is currently in alpha. It has been tested against Tavus's API documentation but not yet battle-tested with live production workloads. If you run into issues, please let us know.
The Tavus connector syncs your AI video generation data into PostHog, including videos, replicas (trained digital likenesses), personas (conversational AI configurations), and conversations (real-time CVI sessions).
Adding a data source
- Go to the Data pipeline page and select the Sources tab.
- Click + New source and select Tavus by clicking the Link button.
- Enter your API key. See Getting your API key below.
- Click Next.
- Select the tables you want to import, set the sync method and frequency, then click Import.
The data warehouse then starts syncing your Tavus data. You can see details and progress in the data pipeline sources tab.
Getting your API key
To connect Tavus to PostHog, you need a Tavus API key:
- Log in to your Tavus account at platform.tavus.io.
- Navigate to the API Keys page.
- Create a new API key or copy an existing one.
- Paste the key into PostHog when linking the source.
The API key provides read access to all your Tavus data, including videos, replicas, personas, and conversations.
Configuration
| Option | Type | Required |
|---|---|---|
API key | password | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
videos | A Tavus generated video — a rendered talking-head video produced from a script and a replica. | Full refresh | — | — |
replicas | A Tavus replica — a trained digital likeness used to generate personalized videos. | Full refresh | — | — |
personas | A Tavus persona — the conversational configuration (system prompt, layers, replica) for a CVI agent. | Full refresh | — | — |
conversations | A Tavus conversation — a real-time Conversational Video Interface (CVI) session with a replica. | Full refresh | — | — |
Sync modes
All Tavus tables use full refresh sync. Tavus's API doesn't support incremental filtering, so each sync fetches all records.
| Table | Sync method |
|---|---|
videos | Full refresh |
replicas | Full refresh |
personas | Full refresh |
conversations | Full refresh |
Available tables
| Table | Description |
|---|---|
videos | Generated talking-head videos produced from a script and a replica |
replicas | Trained digital likenesses used to generate personalized videos |
personas | Conversational configurations (system prompt, layers, replica) for CVI agents |
conversations | Real-time Conversational Video Interface (CVI) sessions with a replica |