Skip to main content
All integration guides
Recruitee integration

Connect Recruitee to Marxel

Bring jobs and candidates into Marxel, then return screening notes and pipeline decisions to Recruitee.

About 10 minutesReviewed 20 July 2026

Before you start

  • A Marxel organization admin account
  • A Recruitee role that can manage API tokens and webhooks

Check your permissions

In Recruitee, open Settings, then Company, Hiring roles. Use a role with Manage API tokens and Manage webhooks enabled.

The personal token inherits the hiring role of the person who creates it. If either setting is missing, ask a Recruitee administrator to update the role or complete these steps.

Recruitee Hiring roles Add-ons tab with Manage API tokens and Manage webhooks permissions
The relevant permissions are in the hiring role Add-ons tab.Recruitee source

Create a personal API token

  1. 1. In Recruitee, go to Settings, Apps and plugins, Personal API tokens.
  2. 2. Copy the numeric Company ID shown under Current company details.
  3. 3. Select New token, give it a recognizable name such as Marxel, and copy the token. Store it securely while you finish setup.
Recruitee Personal API Tokens page with company details, token list, and New token button
The Company ID and token controls appear on the same Recruitee settings page.Recruitee source
Recruitee says personal API tokens do not expire automatically. Revoke the token in Recruitee if it is exposed or no longer needed.

Connect Recruitee in Marxel

  1. 1. Open Organization settings, Integrations.
  2. 2. Find Recruitee and paste the Company ID and API token from the previous step.
  3. 3. Select Connect. Marxel validates the credentials before saving the connection.

Credential handling

Marxel encrypts the Recruitee credentials before storing them. The API token is never returned to the browser after connection.

Add candidate webhooks

Webhooks tell Marxel when candidates are added or change jobs, so you do not need to run a manual synchronization for every update.

  1. 1. On the connected Recruitee card in Marxel, select Set up beside Candidate webhook and copy the endpoint URL.
  2. 2. In Recruitee, go to Settings, Apps and plugins, Webhooks.
  3. 3. Create webhooks using the Marxel endpoint for new candidate, candidate assigned, and candidate moved events.
  4. 4. Reveal Recruitee's signing secret, paste it into the Marxel webhook modal, then select Save setup.
Recruitee Webhooks settings with active webhooks and a masked signing secret
Recruitee lists active webhooks and the shared signing secret on this page.Recruitee source

Sync jobs and configure writeback

  1. 1. Open the Recruitee card menu in Marxel and select Sync jobs.
  2. 2. Select Configure beside stage movement. Map Aligned, Potential, Hold, and Unclear to the appropriate Recruitee pipeline stage for each synced job.
  3. 3. Enable Post screening notes if Marxel should add its summary, recommendation, and review link to the candidate profile.
  4. 4. Enable Move candidates between stages after every synced job has complete stage mappings.

A safe rollout

Start with notes only, review a few screened candidates in Recruitee, then enable stage movement when the mappings match your hiring workflow.

Troubleshooting

Recruitee rejects the credentials

Check that the Company ID is numeric, the token is still active, and the token creator can access the company you are connecting.

Candidate updates do not arrive

Confirm all three webhook event types use the endpoint shown in Marxel. Then compare the signing secret in both systems and inspect Recruitee webhook logs for failed deliveries.

Stage movement cannot be enabled

Run a job sync first, then complete all four bucket mappings for every synced job. Marxel keeps stage movement disabled until the mapping is complete.

Ready to connect?

Keep this guide open while you complete the Recruitee card in your organization settings.

Open integrations