> AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt

# Linking Huntr as a source

Canonical URL: https://posthog.com/docs/data-pipelines/sources/huntr

> **Cloud region:** This page uses US Cloud hosts. For an EU Cloud project, use `https://eu.posthog.com` instead of `https://us.posthog.com` or `https://app.posthog.com` (app host for links).

## On this page

- [Creating a Huntr access token](#creating-a-huntr-access-token)
- [Linking Huntr](#linking-huntr)
- [Configuration](#configuration)
- [Supported tables](#supported-tables)
- [Sync modes](#sync-modes)
- [Available datasets and endpoints](#available-datasets-and-endpoints)

**Beta release**

This source is currently in **beta**. It works end to end, but you may still hit rough edges. [Let us know](https://us.posthog.com/#panel=support%3Asupport%3Adata_warehouse%3A%3Atrue) if you do.

![](https://res.cloudinary.com/dmukukwp6/image/upload/texture_tan_9608fcca70)

![](https://res.cloudinary.com/dmukukwp6/image/upload/texture_tan_dark_a92b0e022d)

Let AI connect your sources for you

Skip the manual setup — run this in your project and the wizard auto-detects your databases and APIs and connects them to PostHog.

`npx @posthog/wizard warehouse`

![PostHog Wizard hedgehog](https://res.cloudinary.com/dmukukwp6/image/upload/wizard_3f8bb7a240.png)

![](https://res.cloudinary.com/dmukukwp6/image/upload/wizard_3f8bb7a240.png)Let AI connect your sources for you

The Huntr connector syncs your recruiting and job search tracking data into PostHog, including members, advisors, candidates, jobs, job posts, employers, activities, and actions.

## Creating a Huntr access token

Huntr uses Bearer token authentication with an organization access token. The token grants read access to your organization's data.

1.  Log in to your Huntr organization admin dashboard.
2.  Navigate to the API or access token settings.
3.  Generate an organization access token.
4.  Copy the token.

For more details, see [Huntr's API documentation](https://docs.huntr.co).

## Linking Huntr

1.  Go to the [Data pipeline sources page](https://app.posthog.com/data-management/sources) in PostHog.
2.  Click **\+ New source** and then click **Link** next to Huntr.
3.  Paste your Huntr **organization access token**.
4.  Click **Next**, choose the tables you want to sync, and then click **Import**.

Once the sync completes, you can query your Huntr data directly in PostHog.

## Configuration

| Option | Type | Required |
| --- | --- | --- |
| `Organization access token` | password | Yes |

## Supported tables

| Table | Description | Sync method | Incremental field | Primary key |
| --- | --- | --- | --- | --- |
| `members` | A member (job seeker) whose job search the organization is following in Huntr. | Full refresh | — | — |
| `advisors` | An advisor — an organization team member who manages and supports job seekers. | Full refresh | — | — |
| `candidates` | A candidate profile managed within the organization. | Full refresh | — | — |
| `jobs` | A job a member is tracking on their board (a saved role and its application progress). | Full refresh | — | — |
| `job_posts` | A job post published or shared by the organization to its members. | Full refresh | — | — |
| `employers` | An employer tracked by the organization. | Full refresh | — | — |
| `activities` | An activity — an interview, task, or event linked to a member's job search. | Full refresh | — | — |
| `actions` | An action recorded against a member or job (Huntr's successor to the deprecated events resource). | Full refresh | — | — |
| `activity_categories` | A category that classifies an activity, such as Apply, Phone Interview, or Offer Received. | Full refresh | — | — |
| `tags` | A tag the organization created to label records such as job posts. | Full refresh | — | — |
| `candidate_action_metrics` | Per-candidate counts of an action type that employers performed, such as viewing the candidate profile. | Full refresh | — | — |

## Sync modes

All Huntr tables use **full refresh** syncing — data is completely re-downloaded on every sync. The Huntr Organization API doesn't expose reliable `updated_after` filters across its endpoints, so incremental syncing is not supported.

## Available datasets and endpoints

| Dataset | Endpoint path | Sync mode | Primary key |
| --- | --- | --- | --- |
| `members` | `/members` | Full refresh | `id` |
| `advisors` | `/advisors` | Full refresh | `id` |
| `candidates` | `/candidates` | Full refresh | `id` |
| `jobs` | `/jobs` | Full refresh | `id` |
| `job_posts` | `/job_posts` | Full refresh | `id` |
| `employers` | `/employers` | Full refresh | `id` |
| `activities` | `/activities` | Full refresh | `id` |
| `actions` | `/actions` | Full refresh | `id` |

All endpoints use the Huntr Organization API (`api.huntr.co/org`).