> ## Documentation Index
> Fetch the complete documentation index at: https://developers.nlpearl.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Twilio Integration
> Learn how to integrate your Twilio account with NLPearl.AI and use your Twilio phone numbers.
Integrate your Twilio account with NLPearl.AI to use your existing Twilio phone numbers on our platform.
This integration allows you to leverage your Twilio numbers for inbound and outbound campaigns,
providing access to a wide range of phone numbers from various countries while ensuring compliance with local regulations.
***
### How to Integrate Your Twilio Account
Follow these steps to integrate your Twilio account with NLPearl.AI:
Start by clicking your **profile card** (1) at the bottom-left corner of the sidebar. This opens the Settings panel.
From there, go to the **Phone Numbers tab** (2) to manage or purchase phone numbers linked to your account.
In the **Phone Numbers** tab, locate the **Connect to Twilio** button in the center of the screen.
Click this button to link your Twilio account and access the list of available phone numbers provided by Twilio.
Once you click the **Connect to Twilio** button, you'll be prompted to link your Twilio account. There are two ways to authenticate:
#### Option 1: Use Account SID + Auth Token
This is the simplest method. Use it if you prefer to connect directly with your main Twilio credentials.
* **Account SID**: Enter your Twilio Account SID.
* **Auth Token**: Enter your Twilio Auth Token.
***
You can find both values in your [Twilio Console](https://www.twilio.com/console), under the **Account Info** section at the bottom of the dashboard.
***
#### Option 2: Use API Credentials (more secure)
If you prefer a more secure or limited-access integration, use API credentials.
* **Account SID**: Same as above.
* **API Key SID**: Enter your Twilio API Key SID.
* **API Secret Key**: Enter your Twilio API Secret Key.
***
To connect via API Key authentication, you’ll need to generate API credentials from your Twilio Console.
Visit the [Twilio API Keys page](https://www.twilio.com/console/project/api-keys) in your console. This is where all your existing keys are listed, and where you can create new ones.
Click the **Create API Key** button on the top right of the API Keys page.
Give your key a name and select **Standard** as the key type. Then click **Create**.
Once the key is created, Twilio will display both the **SID** and the **Secret**.
You will only see the **Secret Key** once — make sure to copy and store it somewhere safe.
Once your Twilio account is connected, a list of all available phone numbers will appear.
To import a number into NLPearl, click the **Add** button next to it (2).
When you’re done, click **Finish** to complete the import process.
The selected numbers will immediately appear in your NLPearl account. You can return to this screen at any time to import additional numbers — especially if you’ve added new ones to your Twilio account later on.
If you use multiple Twilio accounts with different sets of phone numbers, you can easily switch between them without losing your imported data.
On the Twilio integration page, locate the current account section (1). Hovering over it will display the **Twilio Account SID** currently in use.
Click the **Change Account** button at the bottom (2) to enter new Twilio credentials.
Already imported phone numbers will remain linked to your NLPearl account — switching accounts won’t affect them.
You can repeat this process at any time to import phone numbers from another Twilio account.
If you no longer need a phone number, you can schedule it for deletion directly from your settings.
Start by going to the **Phone Numbers** section in your Settings. From there, locate the number you want to remove and click the **Delete** button next to it.
A confirmation step will appear to make sure you really want to delete the selected number. The phone number will be removed from your NLPearl account immediately.
Deleting a phone number from NLPearl does not delete it from your Twilio account. Ensure that the phone number isn't used in any running activities before deleting it from the platform.
***
### Disabling HTTP Basic Authentication for Media Access
To ensure full functionality, disable HTTP Basic Authentication for media access in Twilio:
Start by logging into your **Twilio dashboard**. In the left-hand navigation, click on **Voice** (1) to open the voice-related settings. Under the Voice section, select **Manage** (2), then click on **General** (3) to access the general voice configuration panel.
Once you're in the **Voice > General** settings, scroll down to the **HTTP Basic Authentication for media access** section.
Under this section, select **Disable** to allow media URLs to be publicly accessible (1). Then, click the **Save** button at the bottom of the page (2) to apply your changes.
By disabling this setting, you ensure that NLPearl.AI can access and use media resources without authentication issues.
***
### Advantages of Twilio Integration
* **Access to Global Phone Numbers**: Use phone numbers from countries not directly supported by NLPearl.AI by purchasing them through Twilio.
* **Compliance with Country Regulations**: Twilio handles country-specific regulations, allowing you to purchase numbers that comply with local laws.
* **Leverage Existing Numbers**: Utilize the phone numbers you already own in Twilio without needing to acquire new ones.
### Important Considerations
* **Phone Number Management**: Purchase and manage phone numbers through your Twilio account. NLPearl.AI allows you to use these numbers within our platform.
* **Removing Phone Numbers**: Deleting a phone number from NLPearl.AI doesn't affect its status in your Twilio account.
* **Running Activities**: Before deleting a phone number from NLPearl.AI, ensure it's not assigned to any active campaigns or activities to prevent disruptions.
***
If you need assistance with the integration process or have questions about using Twilio phone numbers with NLPearl.AI, please refer to our support resources or contact our support team.
