Convex
Use this guide to set up the Convex destination connector and find reference information.
Get started with Convex at the Convex website. View your data on the Convex dashboard.
Overview
The Convex destination connector supports Full Refresh Overwrite, Full Refresh Append, Incremental Append, and Incremental Dedup. For Incremental Dedup, Convex stores a deduped snapshot but not a history table. Some other destinations that use DBT store a history table. Convex also supports Change Data Capture (CDC) and the replication of incremental deletes.
Output schema
Each stream outputs to a table in Convex. Convex’s table naming rules apply. Table names can only contain letters, digits, and underscores. They can’t start with an underscore.
Each record is a document in Convex. During sync, Convex assigns the _id and _creationTime fields.
For Incremental Dedup, primary key field names must start with a letter. They can only contain letters, digits, and underscores. Convex’s streaming import API doesn’t support source primary keys such as _id. Select a compatible primary key or use Append mode.
Performance
Choose the sync method and frequency that match the amount of data streaming from the source. Large, frequent Full Refresh syncs may reduce performance. Prefer Incremental modes when supported, especially for large tables. If you experience performance issues, contact Convex support by email or use Discord.
Supported sync modes
| Sync mode | Supported? |
|---|---|
| Full Refresh - Overwrite | Yes |
| Full Refresh - Append | Yes |
| Full Refresh - Overwrite + Deduped | Yes |
| Incremental Sync - Append | Yes |
| Incremental Sync - Append + Deduped | Yes |
Get started
Requirements
- Convex Account
- Convex Project
- Deploy key
Set up the connector
Airbyte integration is available to all Convex developers.
On the Convex dashboard, open the project and deployment you want to sync.
- Open the Settings tab.
- Copy the “Deployment URL” from the settings page to the
deployment_urlfield in Airbyte. - Click “Generate a deploy key”. Ensure the key has the
deployment:backups:importpermission described in the Convex streaming import documentation. - Copy the generated deploy key into the
access_keyfield in Airbyte.
Namespace support
This destination supports namespaces.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.2.20 | 2026-10-09 | 88404 | Mark access_key as airbyte_secret (boolean instead of the string “true”) |
| 0.2.19 | 2026-10-07 | 88204 | Preserve checkpoint IDs and fix namespaced overwrite and dedup setup |
| 0.2.18 | 2025-05-10 | 59863 | Update dependencies |
| 0.2.17 | 2025-05-03 | 59357 | Update dependencies |
| 0.2.16 | 2025-04-26 | 58683 | Update dependencies |
| 0.2.15 | 2025-04-19 | 58288 | Update dependencies |
| 0.2.14 | 2025-04-12 | 57666 | Update dependencies |
| 0.2.13 | 2025-04-05 | 57164 | Update dependencies |
| 0.2.12 | 2025-03-29 | 56563 | Update dependencies |
| 0.2.11 | 2025-03-22 | 56128 | Update dependencies |
| 0.2.10 | 2025-03-08 | 43824 | Update dependencies |
| 0.2.9 | 2025-03-03 | 55175 | Update to CDK 6.0+ and baseImage 4.0.0 |
| 0.2.8 | 2024-08-22 | 44530 | Update test dependencies |
| 0.2.7 | 2024-07-31 | 42585 | Improve error handling |
| 0.2.6 | 2024-07-09 | 41275 | Update dependencies |
| 0.2.5 | 2024-07-06 | 40987 | Update dependencies |
| 0.2.4 | 2024-06-25 | 40496 | Update dependencies |
| 0.2.3 | 2024-06-22 | 40122 | Update dependencies |
| 0.2.2 | 2024-06-04 | 39083 | [autopull] Upgrade base image to v1.2.1 |
| 0.2.1 | 2024-05-21 | 38527 | [autopull] base image + poetry + up_to_date |
| 0.2.0 | 2023-05-15 | 26103 | 🐛 Update Convex destination connector to fix overwrite sync mode |
| 0.1.0 | 2023-01-05 | 21287 | 🎉 New Destination: Convex |