> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.smstools.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Connecting Carerix with Smstools

Smstools integrates with **Carerix** so your recruiters can send SMS to candidates directly from Carerix and receive their replies back inside Carerix. No development work is required on your side — we set up the connection for you.

## What the integration does

- **Send SMS from Carerix:** a recruiter sends an SMS straight from Carerix and Smstools delivers it to the candidate.
- **Two-way replies:** when a virtual number is used on your account, a candidate's reply is returned into Carerix as a task linked to the recruiter and the candidate, so the full conversation stays in Carerix.
- **Failed messages:** if a message cannot be sent (for example an invalid number, an unknown sender, or a message that is too long), a task "SMS failed" is created in Carerix so your recruiter is notified.

## How it works

**Outbound:** Recruiter in Carerix → Carerix forwards the message to Smstools → Smstools sends the SMS → Candidate.

**Reply:** Candidate replies → the reply arrives on your virtual number → a task is created in Carerix for the recruiter and the candidate.

## What you provide

To connect your Carerix environment, you — together with your Carerix consultant — provide four things:

1. An **API user and password** for your own Carerix environment.
2. The **IDs from your Carerix** (from your Carerix consultant): the activity type for an SMS reply, for a failed SMS and for a failed verification (these may be the same), plus the task status and the task type.
3. The **SMS-via-mail** setting in Carerix, pointing to the address we give you, with the subject in the form `mobilenumber/[connectid]/ownerid`.
4. The **e-mail address(es)** Carerix uses to send those messages — one address per office if you have several.

## Getting started

Contact **support@smstools.com** to start the setup. We create your Smstools account, add a virtual number for two-way replies and connect it to your Carerix environment. Together we run a short test: send an SMS from Carerix, reply from a mobile phone and confirm the task appears in Carerix.

> **Note:** two-way replies require a virtual number on your account. Without one, messages can be sent but candidate replies cannot be returned into Carerix.