# Linking Huntr as a source - Docs

![](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`

[Learn more](/wizard.md)

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

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

**Alpha release**

This source is currently in alpha. Endpoint behavior was verified against Huntr's public Organization API documentation but hasn't been tested against every edge case in production. If you run into issues, please let us know.

## 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 | — | — |

## 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`).

### Community questions

Ask a question

### Was this page useful?

HelpfulCould be better