> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recruiterflow

> Log every Allo call as a native Recruiterflow call on the matching candidate or client contact, log SMS on the profile, and sync your candidates, client contacts and clients to Allo

Allo logs every call as a native Recruiterflow **call** on the matching candidate or client contact, with the call outcome, the summary, the tags and a link to the recording. SMS are logged on the same profile. Your Recruiterflow candidates, client contacts and clients sync into Allo, so you know who is calling before you pick up.

## How to connect

The Recruiterflow integration connects with your Recruiterflow API key. You need an Allo admin or manager to connect the integration, and a Recruiterflow admin to copy the API key.

### Get your Recruiterflow API key

**1. Open the integration settings**

In Recruiterflow, sign in as an admin and go to **Settings** > **Integrations** > **Recruiterflow API key**.

**2. Generate the API key**

Click **Generate API key** if your account has no API key yet.

**3. Copy the API key**

Copy the API key. You paste the API key into Allo in the next step.

> [!WARNING]
>
> Recruiterflow has one API key per account, shared by every integration on the account. If someone regenerates the API key, Allo and your other integrations stop working until you connect them again with the new API key.

> [!NOTE]
>
> If you don't see **Recruiterflow API key** in your integration settings, ask Recruiterflow support to enable API access on your account.

### Connect in Allo

**1. Open integrations**

Go to [**web.withallo.com**](https://web.withallo.com) and navigate to **Settings** > **Integrations**.

**2. Find Recruiterflow**

Find **Recruiterflow** in the list and click **Connect**.

**3. Paste your API key**

Paste the API key you copied from Recruiterflow in the **API key** field.

**4. Save and connect**

Click **Save & Connect**. Allo imports your candidates, client contacts and clients.

## What syncs

**From Recruiterflow to Allo:**

* Candidates, with their name, emails, phone numbers, current title and organization, tags, status, owner and a link to the candidate in Recruiterflow
* Client contacts, with their name, emails, phone numbers, title, client company, tags, status, owner and a link to the contact in Recruiterflow
* Clients, with their name, website, phone numbers, address, industry, size and owner, and a link to the client in Recruiterflow

**From Allo to Recruiterflow:**

* Calls, logged as Recruiterflow calls on the matching candidate or client contact
* SMS, logged on the matching candidate or client contact
* New candidates, only when **Create lead for unknown calls** is enabled. Allo creates the person as a **Candidate** with the source **Allo**, with the name, emails, phone numbers and job title known in Allo.

Allo only fills in empty fields on an existing candidate or client contact and adds emails and phone numbers the person doesn't have yet. Allo never overwrites a name or title already set in Recruiterflow, and never turns a client contact into a candidate.

Every 30 minutes, Allo syncs the candidates and client contacts added or with new activity in Recruiterflow (a call, an email, a note) since the last sync. Once a week, Allo reads all your candidates and client contacts again, so edits without any activity, such as a phone number fixed by hand, reach Allo within a week. Clients sync every hour. Candidates and client contacts without a phone number are not synced to Allo. Deleting a person in Recruiterflow does not remove the contact from Allo.

Jobs, deals and placements are not synced.

When a call comes in or goes out, Allo looks the number up in your candidates and your client contacts, in several national and international formats, such as `+14155551234`, `(415) 555-1234` or `06 12 34 56 78`. If a candidate and a client contact have the same number, Allo picks the one with the most recent activity in Recruiterflow.

## How calls are synced

After each call, Allo creates a native Recruiterflow **call** on the matching candidate or client contact. For a client contact, the call is also linked to the contact's client. The call has:

* The call outcome: **Connected** for an answered call, **Left Voicemail** for a voicemail, **Busy** for a busy line, and **No Answer** for a missed or unanswered call
* A title with the direction, the result, the Allo user and the duration, for example `Allo Outbound Call - Answered - Jane Doe (5:12)`
* The start and end time of the call
* Notes with who called whom and on which Allo line, the call tags, the call summary and a link to the recording

The call transcript is not added to Recruiterflow.

The call is logged under the Recruiterflow user whose email matches the Allo user. If no Recruiterflow user has that email, Allo logs the call under the first admin of your Recruiterflow account. The Allo user's name stays in the call title.

> [!NOTE]
>
> Recruiterflow does not let integrations edit a call once it is logged. If you edit a call's summary, tags or result in Allo afterwards, the call in Recruiterflow keeps what Allo sent first.

If your account renamed or removed the **Connected**, **Left Voicemail**, **Busy** or **No Answer** outcome, Allo files the call under the first outcome of your account.

## How SMS are synced

Recruiterflow does not let integrations create text messages, so Allo logs SMS in one of two ways:

* **With an SMS activity type:** if a Recruiterflow admin has created a custom activity type named **SMS**, **Text**, **Text Message** or **Allo SMS**, Allo groups each day's SMS with a person into one activity of that type, titled for example `Text Message - Jane Whitaker - 9 Nov 2026`. Each message is added to that day's activity with its time, its direction and the Allo user.
* **Without it:** Allo adds one **note** per SMS on the candidate or client contact, with the same title, time, direction, Allo user and message.

To group SMS in one activity per day, ask a Recruiterflow admin to create a custom activity type named **SMS** in your Recruiterflow settings. Allo uses it for the next SMS, with no change in Allo.

## Click-to-call

Click-to-call is not available for this integration. To call a number from a Recruiterflow page, use the [Allo Chrome extension](https://help.withallo.com/en/integrations/chrome-extension.md).

## Troubleshooting

Check the sync status of any call from the **call list on [web.withallo.com](https://web.withallo.com)**. Each call has an integration indicator showing its sync state.

> [accordion] I cannot connect my integration
>
> Only **admins** and **managers** of an Allo workspace can connect integrations. If you don't see the option, ask your workspace admin or manager to set it up.
>
> On the Recruiterflow side, check these points:
>
> * **The API key is incomplete.** Copy the whole API key from **Settings** > **Integrations** > **Recruiterflow API key**. Allo only accepts letters, digits and underscores.
> * **The API key was regenerated.** A new API key replaces the old one. Copy the current API key and connect again.
> * **API access is not enabled.** If your Recruiterflow account shows no API key, ask Recruiterflow support to enable API access.

> [accordion] Call not synced to my integration
>
> Check the integration indicator on the call in the web app. The error will be one of these:
>
> * **Contact not found**: the number is not on any candidate or client contact in Recruiterflow. By default, Allo only syncs calls to existing people. To create unknown callers as candidates, go to your integration settings and enable **Create lead for unknown calls**.
> * **Contact deleted**: the person was removed from Recruiterflow. Allo is additive and won't sync calls for deleted people. Re-create the person in Recruiterflow, then retry the sync.
> * **Integration disconnected**: the Recruiterflow API key was regenerated. Allo still appears connected but requests fail. Disconnect and reconnect the integration in Allo with the current API key.
> * **Call pending (spinner icon)**: Allo is still matching the contact. This can take up to 24 hours before being marked as an error. Once the person exists in Recruiterflow, you can retry manually.
> * **Contact is a favorite**: by default, calls with a favorite contact are not synced to your CRM. Remove the contact from your favorites if you want these calls to sync.

> [accordion] Contacts not syncing
>
> The first sync reads all your candidates, client contacts and clients, and can take a while on a large Recruiterflow account. After that, Allo syncs every 30 minutes the people added or with new activity, and reads everyone again once a week.
>
> A change without any activity in Recruiterflow, such as a phone number fixed by hand, reaches Allo at the weekly sync. To speed it up, log any activity on the person, such as a note.
>
> Allo only syncs candidates and client contacts that have at least one phone number. People without a phone number will not appear in Allo.

> [accordion] SMS not synced
>
> Look for the SMS on the candidate or client contact in Recruiterflow: in the day's **SMS** activity if your account has that activity type, otherwise in a note.
>
> If the SMS is missing, verify the integration is connected in **Settings** > **Integrations** and check the integration indicator on the call list at [web.withallo.com](https://web.withallo.com) for error details. If SMS still don't appear, disconnect and reconnect the integration.

> [accordion] Duplicate contacts
>
> Allo mirrors your integration exactly. If Recruiterflow has duplicate candidates or client contacts with the same phone number, they appear as separate contacts in Allo.
>
> With **Create lead for unknown calls** enabled, Allo first looks for an existing candidate or client contact by email, then by phone number, and only creates a candidate when it finds none. Merge duplicates in Recruiterflow. Allo will reflect the change on the next sync.

> [accordion] Call synced to the wrong contact
>
> When a candidate and a client contact share the same phone number, Allo logs the call on the one with the most recent activity in Recruiterflow. Before reporting a missing sync, check every person who shares that phone number: the call may already be on another one. Click the integration indicator on any call in the web app to see exactly which contact it was synced to.

> [accordion] The call is under the wrong Recruiterflow user
>
> Allo logs the call under the Recruiterflow user whose email matches the Allo user's email. If the emails differ, the call is logged under the first admin of your Recruiterflow account, with the Allo user's name in the call title. Use the same email in Allo and Recruiterflow.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.