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

> ## Agent Instructions
> This is the Journeyfront Help Center for hiring teams. Journeyfront is an applicant tracking system (ATS). Use the Help Center's terms: job req, Candidate Profile (the person), Candidate Application (one person on one job req), hiring class. Link to the article you used in your answer.

# Twilio

> Text candidates through Journeyfront's Twilio account or connect your company's own Twilio account.

> [!NOTE]
>
> **Who can do this:** Admins with the *Company Settings Access* permission. Connecting your own account also needs someone who can make changes in your Twilio console.
>
> **Availability:** The Text Messages add-on needs to be turned on for your account. Ask your Customer Success Manager.

Twilio is the most common way to text candidates from Journeyfront. You can use a Twilio account that Journeyfront provides and manages for you, or connect your company's own Twilio account, with your own numbers, carrier registrations and billing.

For how texting providers compare, the Text Messages page and phone numbers, see [Texting providers](https://help.journeyfront.com/integrations/texting-providers.md). To connect WhatsApp through Twilio, see [WhatsApp](https://help.journeyfront.com/integrations/texting-providers/whatsapp.md#whatsapp-through-twilio).

## Journeyfront's Twilio account

When Journeyfront provides your Twilio account, there's nothing for you to set up. Your Customer Success Manager connects it and adds your number, and the Twilio section reads "Managed by Journeyfront." There's no candidate replies step to set up. Usage comes out of the prepaid messaging balance on the **Billing** card. See [Add-ons and credits](https://help.journeyfront.com/account-setup/add-ons.md).

Because Journeyfront manages these accounts, you can't change their credentials from your settings. Contact your Customer Success Manager if something needs to change.

## Connect your own Twilio account

You'll need:

* Your Twilio **Account SID** and primary **Auth Token**
* A phone number in your Twilio account that can send texts
* A **Messaging Service** in Twilio that includes that number (needed for candidate replies)

**1. Add Twilio**

Go to **Settings**, then **Add-Ons**, then **Text Messages**. Under **Text messaging**, click **Add Twilio**, or open the Twilio section if it's already there.

**2. Enter your Account SID**

It starts with "AC" and is on the Account Info panel of your Twilio console.

**3. Enter your Auth Token**

Use your primary auth token, not an API key secret.

**4. Connect Twilio**

Click **Connect Twilio**. Journeyfront checks your credentials with Twilio before saving them. After that, it only ever shows the last four characters of your Account SID.

> [!TIP]
>
> Don't use a Twilio API key (it starts with "SK"). Journeyfront refuses it, because texts would still go out but candidate replies couldn't be matched to your account.

To change credentials later, for example after you rotate your token in Twilio, click **Update credentials** on the **Twilio account** step, enter the new ones and click **Save credentials**. Journeyfront checks the new ones before replacing the old ones.

## Add your Twilio sending number

**1. Open Phone Numbers**

On the **Sending number** step, click **Add number** (or **Manage numbers**). This opens **Settings**, then **Phone Numbers**. Click **+ Phone Numbers**.

**2. Choose Twilio**

If you also text through Webex Connect, set **Sends Through** to **Twilio**.

**3. Pick your number**

Choose your number from the list of numbers in your Twilio account that aren't added yet, and save. Numbers that can't send texts show "(no SMS)" and can't be picked. If your number isn't listed, click **Don't see your number? Enter it manually** and type it in.

To get a new number, buy it in your Twilio console. Once it's there, it appears in this list.

## Turn on Twilio candidate replies

Twilio sends candidate replies to Journeyfront through the Messaging Service that holds your sending number. The **Candidate replies** step checks it for you:

| What the step shows | What to do |
| - | - |
| **On** | Nothing. Replies already reach Journeyfront. |
| **Off**, with **Enable replies** | Click **Enable replies** and Journeyfront sets up your Messaging Service. If Twilio doesn't say which service holds your number, you'll see a list of services: choose the right one. |
| Your number isn't in any service | In Twilio, go to **Messaging**, then **Services**, and add your number to a service's sender pool. Then click **Check again**. |
| Your Twilio account has no messaging services | Create a Messaging Service in Twilio and add your number to it. Then click **Check again**. |

Changed something in Twilio? Click **Changed something in Twilio? Check again** to refresh the step.

## Twilio troubleshooting

| What you see | What to try |
| - | - |
| Your Account SID is refused as an API key | Copy the Account SID that starts with "AC" from your Twilio Account Info panel, and use your primary auth token. |
| Texts send, but candidate replies never show up | Look at the **Candidate replies** step. It tells you whether your Messaging Service sends replies to Journeyfront, and what to do if not. |
| **Candidate replies** went back to **Off** | Click **Enable replies** again. |
| The step says your account has no messaging services | Create a Messaging Service in Twilio, add your number to its sender pool, then click **Check again**. |
| Your number isn't in the list | It's already added, it can't send texts (listed as "(no SMS)"), or it's in a different Twilio account from the one you connected. You can also click **Don't see your number? Enter it manually**. |
| A message shows **Not delivered** | Hover over it to see the reason. |

## FAQ

> [accordion] Should we use Journeyfront's Twilio account or our own?
>
> Journeyfront's Twilio account is the simplest way to start. If you already run Twilio, with your own numbers, carrier registrations and billing, connect your own account.

> [accordion] Do we need to register with U.S. carriers?
>
> U.S. carriers require A2P 10DLC registration for reliable texting to U.S. numbers. With your own Twilio account, you complete it in Twilio. If Journeyfront provides your account, ask your Customer Success Manager.

> [accordion] Who bills us for texts?
>
> With Journeyfront's Twilio account, usage comes out of your prepaid messaging balance in Journeyfront. With your own Twilio account, Twilio bills you directly.

## Related

> [card] [Texting providers](https://help.journeyfront.com/integrations/texting-providers.md)
>
> Compare providers, and manage phone numbers and billing.

> [card] [WhatsApp](https://help.journeyfront.com/integrations/texting-providers/whatsapp.md)
>
> Connect a WhatsApp Business number through Twilio.


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