---
title: "Connect JOIN to Metaintro | Metaintro"
canonical: "https://www.metaintro.com/help/connect-join-to-metaintro"
language: "en"
author: "Metaintro"
published: "2026-11-11T16:02:27.402Z"
modified: "2026-11-11T16:02:42.312Z"
---

# Connect JOIN to Metaintro

Create a JOIN API token and connect it so candidates who share with you arrive on the right JOIN job.

Last updated: November 11, 2026[Employers](/help/category/employers)

Paste it into Claude, ChatGPT, Codex, Cursor or Pi.

## Before you start

You need a JOIN System Admin. Only System Admins can create API tokens.

Your JOIN subscription must include API access. If it doesn't, the Developer section shows an upgrade prompt instead.

You will paste one thing into Metaintro: a JOIN API token.

## Create the credential in JOIN

1. Sign in to JOIN as a System Admin.
2. Open Settings > Developer > API tokens.
3. Create a token and name it Metaintro, so you can tell it apart from your other integrations.
4. Copy the full token. JOIN shows it only once.

A company can have up to 10 tokens. JOIN's guide: [Authentication and access](https://docs.join.com/reference/authentication-1).

## Connect in Metaintro

1. In Metaintro, go to Settings > Integrations.
2. Choose JOIN.
3. In API token, paste the token you copied.
4. Select Connect.

Metaintro checks the token by reading your jobs. Then map your JOIN jobs to your Metaintro jobs, set your rules, preview, and go live.

## What Metaintro sends and reads

Metaintro only sends people who chose to share their profile with you for that job. For each person, Metaintro:

- Creates an application on the matching JOIN job with their name, email and phone when they shared one.
- Attaches their résumé as the CV when they shared a PDF or Word file.
- Adds a note to the candidate with a link to their proof card, plus their short summary when they wrote one.

If a candidate with the same email is already in JOIN, Metaintro uses that candidate. JOIN keeps their existing profile details.

JOIN doesn't send hiring updates to other apps, so Metaintro checks each shared application regularly. Hired and rejected applications show in Metaintro as hired and not selected. For applications still in progress, Metaintro reads the stage type, such as interview or offer.

When you move a candidate from Metaintro, it moves the JOIN application to the job's stage of the matching type, such as an interview, offer or hired stage. Moving to a hired stage hires the candidate in JOIN, and a stage can send its automated emails, just as a move in JOIN does.

## Limits

- JOIN sets the candidate source itself. You can't set it to Metaintro.
- Only PDF and Word résumés are attached. Other résumé files are left out, and the proof card note still arrives.
- If the person already has an application on that job, JOIN doesn't let Metaintro add a new résumé to it. Metaintro stops instead of sending the person without it.
- Rejections and withdrawals can't be set from Metaintro. Make them in JOIN. JOIN records a withdrawal as a rejection, so it shows as not selected in Metaintro.
- Metaintro sees only published jobs. Drafts don't appear, and archived jobs don't accept new applications.
- Notes can be up to 2,500 characters, and a candidate can have at most 50 notes.
- Stage updates are not instant. Metaintro checks for changes on a schedule.
- Each token can make 100 requests every 10 seconds and 600 every minute. Metaintro paces its requests to stay inside these limits.

## If something goes wrong

- **The token is rejected.** The token may be copied wrong, revoked, or your plan may no longer include API access. JOIN pauses tokens when API access ends. Check your plan, create a new token if needed, and reconnect.
- **A job is missing.** It may still be a draft. Publish it in JOIN, then map it in Metaintro.
- **A candidate isn't added.** The job may be archived, the candidate may be blocked in JOIN, or they may already have an application on that job and shared a new résumé.
- **The note isn't added.** The candidate may already have 50 notes. Delete an old note in JOIN.
- **Metaintro is rate limited.** JOIN asked Metaintro to slow down. Metaintro waits and tries again, so you don't need to do anything.

### Was this article helpful?

## Related Articles

- [Connect your ATS to MetaintroSend people who choose to share with you straight into your applicant tracking system, and see their stage in Metaintro.](/help/connect-your-ats-to-metaintro)

[Return to navigation](#main-navigation)