# Linking Convex as a source - Docs

The Convex connector can sync your Convex database tables to PostHog.

> **Note:** Convex streaming exports require the **Convex Professional plan**. See the [Convex pricing page](https://www.convex.dev/pricing) for details.

## Prerequisites

You need two things from your Convex project:

-   **Deploy URL** – must be in the format `<something>.convex.cloud`. Find it in the Convex Dashboard under **Settings** > **URL & Deploy Key**.
-   **Deploy key** – found in the same location: **Settings** > **URL & Deploy Key**.

## Linking Convex to PostHog

1.  Go to the [Data pipeline page](https://app.posthog.com/data-management/sources) and the sources tab in PostHog
2.  Click **New source** and select Convex
3.  Enter your **Deploy URL** and **Deploy key**
4.  Click **Next**, select the tables you want to sync, and then press **Import**

Once the syncs are complete, you can start using Convex data in PostHog.

## Configuration

| Option | Type | Required |
| --- | --- | --- |
| Deployment URL | text | Yes |
| Deploy key | password | Yes |

### How syncing works

Convex uses its streaming export API to sync data:

-   **Initial sync** – paginates through a full table snapshot using Convex's `/api/list_snapshot` endpoint.
-   **Incremental sync** – fetches only changed documents using Convex's `/api/document_deltas` endpoint. All tables support incremental sync via the `_ts` field, which is a nanosecond mutation timestamp.
-   **Partitioning** – data is datetime-partitioned on the `_creationTime` field.

> **Note:** If the sync cursor is older than approximately 30 days (Convex's retention window), a full resync is required.

#### Inbound IP addresses

We use a set of IP addresses to access your instance. To ensure this connector works, add these IPs to your inbound security rules:

| US | EU |
| --- | --- |
| 44.205.89.55 | 3.75.65.221 |
| 44.208.188.173 | 18.197.246.42 |
| 52.4.194.122 | 3.120.223.253 |

### Community questions

Ask a question

### Was this page useful?

HelpfulCould be better