Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 54 additions & 0 deletions contents/docs/cdp/sources/agilecrm.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
title: Linking AgileCRM as a source
sidebar: Docs
showTitle: true
availability:
free: full
selfServe: full
enterprise: full
sourceId: AgileCRM
---

import SourceSetupIntro from "../_snippets/source-setup-intro.mdx"
import SyncModes from "../_snippets/sync-modes.mdx"
import TroubleshootingLink from "../_snippets/dw-troubleshooting-link.mdx"
import AlphaRelease from "../_snippets/alpha-release.mdx"

<AlphaRelease />

The AgileCRM connector syncs your CRM data into the PostHog Data warehouse, so you can analyze your contacts, deals, and sales activity alongside your product data.

## Prerequisites

You need an Agile CRM account with API access so you can generate an API key. You authenticate with the email address you log in with and that key.

## Adding a data source

<SourceSetupIntro />

When linking AgileCRM, you'll need:

- **Domain** – the subdomain of your Agile CRM URL. For `https://acme.agilecrm.com` the domain is `acme`.
- **Email** – the email address you use to log in to Agile CRM.
- **API key** – find it under **Admin Settings → Developers & API** in your Agile CRM account.

## Sync modes

<SyncModes />

All AgileCRM tables are full refresh only, since the API exposes no incremental sync filter.

## Configuration

<SourceParameters />

## Supported tables

<SourceTables />

## Troubleshooting

- If you get an authorization error, your Agile CRM email or API key is invalid. Generate a new API key under **Admin Settings → Developers & API**, then reconnect.
- If you get a permission error, your Agile CRM account does not have access to this data. Check your API access settings, then reconnect.

<TroubleshootingLink />
51 changes: 51 additions & 0 deletions contents/docs/cdp/sources/aha.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
title: Linking Aha! as a source
sidebar: Docs
showTitle: true
availability:
free: full
selfServe: full
enterprise: full
sourceId: Aha
---

import SourceSetupIntro from "../_snippets/source-setup-intro.mdx"
import SyncModes from "../_snippets/sync-modes.mdx"
import TroubleshootingLink from "../_snippets/dw-troubleshooting-link.mdx"
import AlphaRelease from "../_snippets/alpha-release.mdx"

<AlphaRelease />

The Aha! connector syncs your product roadmap data into the PostHog Data warehouse, so you can analyze your planning and delivery workflows alongside your product data.

## Prerequisites

You need an Aha! account with permission to create an API key. The key inherits your account permissions, so it can read every record you can see.

## Adding a data source

<SourceSetupIntro />

When linking Aha!, you'll need:

- **Account domain** – the first part of your Aha! account host. For `yourcompany.aha.io`, enter `yourcompany`.
- **API key** – create one under **Settings → Personal → Developer → API keys** in your Aha! account.

## Sync modes

<SyncModes />

## Configuration

<SourceParameters />

## Supported tables

<SourceTables />

## Troubleshooting

- If you see an authentication error, your API key is invalid or has been revoked. Create a new key in your Aha! account settings, then reconnect.
- If you see a permissions error, the key is missing the access needed to sync this data. Check the key's account permissions, then reconnect.

<TroubleshootingLink />
54 changes: 54 additions & 0 deletions contents/docs/cdp/sources/algolia.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
title: Linking Algolia as a source
sidebar: Docs
showTitle: true
availability:
free: full
selfServe: full
enterprise: full
sourceId: Algolia
---

import SourceSetupIntro from "../_snippets/source-setup-intro.mdx"
import SyncModes from "../_snippets/sync-modes.mdx"
import TroubleshootingLink from "../_snippets/dw-troubleshooting-link.mdx"
import AlphaRelease from "../_snippets/alpha-release.mdx"

<AlphaRelease />

The Algolia connector syncs your Algolia search data – index records, synonyms, query rules, and indices – into PostHog, so you can analyze your search configuration alongside your product data.

## Prerequisites

You need an Algolia account with access to your Application ID and the ability to create an API key with the ACLs for the data you want to sync.

## Adding a data source

<SourceSetupIntro />

When linking Algolia, you'll need:

- **Application ID** – found in your [Algolia dashboard](https://dashboard.algolia.com/account/api-keys/all) under your account API keys.
- **API key** – create one in the same [Algolia dashboard](https://dashboard.algolia.com/account/api-keys/all). Grant the ACLs for the data you want to sync: `browse` for index records, `settings` for synonyms and query rules, and `listIndexes` for the list of indices.
- **Index name** – the name of the Algolia index you want to sync.

## Sync modes

<SyncModes />

Algolia endpoints do not expose a server-side updated-since filter, so this source is full refresh only.

## Configuration

<SourceParameters />

## Supported tables

<SourceTables />

## Troubleshooting

- If you see an authentication error, check that your Application ID and API key are correct in the Algolia dashboard.
- If a table fails to sync, make sure your API key has the ACL required for it: `browse` for records, `settings` for synonyms and query rules, and `listIndexes` for indices.

<TroubleshootingLink />
54 changes: 54 additions & 0 deletions contents/docs/cdp/sources/apify-dataset.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
title: Linking Apify Dataset as a source
sidebar: Docs
showTitle: true
availability:
free: full
selfServe: full
enterprise: full
sourceId: ApifyDataset
---

import SourceSetupIntro from "../_snippets/source-setup-intro.mdx"
import SyncModes from "../_snippets/sync-modes.mdx"
import TroubleshootingLink from "../_snippets/dw-troubleshooting-link.mdx"
import AlphaRelease from "../_snippets/alpha-release.mdx"

<AlphaRelease />

The Apify Dataset connector syncs the rows of an Apify dataset into PostHog, so you can analyze the output of your Apify Actors and web scrapers alongside your product data.

## Prerequisites

You need an Apify account with an API token that has read access to the dataset's storage, and the ID of the dataset you want to import.

## Adding a data source

<SourceSetupIntro />

When linking Apify Dataset, you'll need:

- **API token** – create one in your [Apify account settings](https://console.apify.com/settings/integrations). The token needs read access to the dataset's storage.
- **Dataset ID** – find it in the [Apify Console](https://console.apify.com/storage/datasets), or use the `username~dataset-name` shorthand.

## Sync modes

<SyncModes />

Apify datasets are full refresh only. The whole dataset is re-imported on every sync.

## Configuration

<SourceParameters />

## Supported tables

<SourceTables />

## Troubleshooting

- If your API token is invalid or has expired, create a new token in your Apify account settings, then reconnect.
- If your token cannot access the dataset, use a token with read access to the dataset's storage, then reconnect.
- If the dataset could not be found, check that the dataset ID is correct and the token can access it.

<TroubleshootingLink />
50 changes: 50 additions & 0 deletions contents/docs/cdp/sources/appfigures.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
title: Linking Appfigures as a source
sidebar: Docs
showTitle: true
availability:
free: full
selfServe: full
enterprise: full
sourceId: Appfigures
---

import SourceSetupIntro from "../_snippets/source-setup-intro.mdx"
import SyncModes from "../_snippets/sync-modes.mdx"
import TroubleshootingLink from "../_snippets/dw-troubleshooting-link.mdx"
import AlphaRelease from "../_snippets/alpha-release.mdx"

<AlphaRelease />

The Appfigures connector syncs your app-store analytics – products, reviews, and sales and revenue reports – into PostHog, so you can analyze your mobile app performance alongside your product data.

## Prerequisites

You need an Appfigures account with access to the developer portal so you can create an API client and Personal Access Token.

## Adding a data source

<SourceSetupIntro />

When linking Appfigures, you'll need:

- **Personal access token** – create an API client and Personal Access Token at [appfigures.com/developers/keys](https://appfigures.com/developers/keys). When creating the client, grant the data sets you want to sync: `products:read` for products, `public:read` for reviews, and `private:read` for sales and revenue reports.

## Sync modes

<SyncModes />

## Configuration

<SourceParameters />

## Supported tables

<SourceTables />

## Troubleshooting

- If you see an invalid or expired token error, create a new Personal Access Token in your Appfigures developer settings, then reconnect.
- If a table fails with a missing scope error, grant the required data sets to your API client, then reconnect.

<TroubleshootingLink />
52 changes: 52 additions & 0 deletions contents/docs/cdp/sources/assemblyai.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
title: Linking AssemblyAI as a source
sidebar: Docs
showTitle: true
availability:
free: full
selfServe: full
enterprise: full
sourceId: AssemblyAI
---

import SourceSetupIntro from "../_snippets/source-setup-intro.mdx"
import SyncModes from "../_snippets/sync-modes.mdx"
import TroubleshootingLink from "../_snippets/dw-troubleshooting-link.mdx"
import AlphaRelease from "../_snippets/alpha-release.mdx"

<AlphaRelease />

The AssemblyAI connector syncs your speech-to-text transcripts into the PostHog Data warehouse, so you can analyze your transcription data alongside your product data. AssemblyAI retains only the last 90 days of transcripts, so only those are available to sync.

## Prerequisites

You need an AssemblyAI account with API access so you can create an API key.

## Adding a data source

<SourceSetupIntro />

When linking AssemblyAI, you'll need:

- **API key** – find your key in the [AssemblyAI dashboard](https://www.assemblyai.com/app/api-keys).
- **Region** – choose the region that matches your account, either US (`api.assemblyai.com`) or EU (`api.eu.assemblyai.com`).

## Sync modes

<SyncModes />

This source is full refresh only.

## Configuration

<SourceParameters />

## Supported tables

<SourceTables />

## Troubleshooting

- If you see an authentication error, your AssemblyAI API key may be invalid or revoked. Create a new key in the AssemblyAI dashboard, then reconnect.

<TroubleshootingLink />
53 changes: 53 additions & 0 deletions contents/docs/cdp/sources/aviationstack.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
---
title: Linking Aviationstack as a source
sidebar: Docs
showTitle: true
availability:
free: full
selfServe: full
enterprise: full
sourceId: Aviationstack
---

import SourceSetupIntro from "../_snippets/source-setup-intro.mdx"
import SyncModes from "../_snippets/sync-modes.mdx"
import TroubleshootingLink from "../_snippets/dw-troubleshooting-link.mdx"
import AlphaRelease from "../_snippets/alpha-release.mdx"

<AlphaRelease />

The aviationstack connector syncs real-time, scheduled, and historical flight data along with aviation reference tables into PostHog, so you can analyze flight and aviation data alongside your product data.

## Prerequisites

You need an aviationstack account with an active access key. Some tables, such as historical flights and certain filters, require a paid plan.

## Adding a data source

<SourceSetupIntro />

When linking Aviationstack, you'll need:

- **Access key** – find it in your [aviationstack dashboard](https://aviationstack.com/dashboard). Note that aviationstack pricing is a monthly request quota tied to your plan.

## Sync modes

<SyncModes />

This source is full refresh only. Every table is re-synced on each run because aviationstack has no server-side updated-at cursor.

## Configuration

<SourceParameters />

## Supported tables

<SourceTables />

## Troubleshooting

- If your access key is invalid or has been deactivated, generate a new key in your aviationstack dashboard, then reconnect.
- If your plan does not grant access to a table, upgrade your aviationstack plan or deselect the restricted tables, then reconnect.
- If you hit your monthly request quota, upgrade your plan or wait for the quota to reset, then resync.

<TroubleshootingLink />
Loading
Loading