Skip to main content
Harly can import candidate applications from JOIN.com into an existing job. This is a one-time migration, not a live synchronization or an OAuth connection.

​
Before you begin

You need:
  • A JOIN account with access to User Settings → API Credentials.
  • A JOIN plan that includes API access. Check JOIN’s current API documentation if the API menu or token generation is unavailable.
  • An existing Harly job where the imported candidates should be placed.
JOIN API tokens can access company data, so create a dedicated token for the import and revoke it after the migration if it is no longer needed.

​
Create the JOIN token

1

Open JOIN settings

Sign in to JOIN and open User Settings → API Credentials.
2

Generate a token

Select Generate new Token and copy the token immediately. JOIN tokens cannot be reactivated after they are revoked.
3

Start the Harly import

In Harly, open Settings → Integrations, find JOIN.com under Candidate sources, or open Candidates → Import candidates and choose JOIN.com.
4

Choose the destination

Select the Harly job, paste the token into JOIN API token, and select Import JOIN candidates.

​
What Harly imports

Harly reads JOIN applications through the JOIN API v2 endpoint https://api.join.com/v2/applications and maps available fields into the candidate profile:
  • First name, last name, email, phone, and location
  • Headline and profile summary
  • LinkedIn, GitHub, and personal website URLs
  • Skills and tags
  • Education and employment history when present
The import is capped at 5,000 candidates per run. Profiles without a first name, last name, or email are skipped and reported in the import summary. Harly does not persist the JOIN token after the request completes.
CVs, application attachments, screening answers, and JOIN application files are not downloaded by this importer yet. Use JOIN’s own export when you need a ZIP containing candidate documents, or keep the original JOIN account as the source of truth for those files.

​
Troubleshooting

For provider details, see JOIN’s API documentation.