# Add new SMS setups (self-serve)

{% hint style="info" %}
Only relevant to self-serve clients. For other packages, Clickatell does this on your behalf.
{% endhint %}

You can add as many SMS setups as you want. This page explains how to:

* [Add a new setup](#adding-a-new-sms-setup)
* [Select setup type & regions](#select-the-setup-type-and-regions)
  * [Select number(s)](#select-number-s)
* [Select API type](#select-the-api-type)
  * [Set up API details](#set-up-api-details-new-api-setups-only)
* [Send test messages](#send-test-messages-optional)

## Adding a new SMS setup

1. Navigate to *My Workspace -> SMS*.
2. Click *+ New SMS Setup*. 

<figure><img src="/files/7vBGFqs9VXU3mJTlAArK" alt=""><figcaption></figcaption></figure>

3. Follow the steps as prompted by the setup wizard (shown below).

### Select the setup type and regions

1. Select how you plan to use the SMS channel: &#x20;
   * **Via API:** You're prompted to select either the [**1-way**](/sms-channel/1-way-sms-communication.md) (sending only) or [**2-way**](/sms-channel/2-way-sms-communication.md) (sending & receiving) messaging type.
   * **Via Campaign Manager:** This tool is ideal for campaigns such as promotions, reminders, alerts, event information, and quick polls. This is managed as a [separate tool](/sms-channel/getting-started/add-new-sms-setups-self-serve/add-campaign-manager.md).

{% hint style="warning" %}
**Note:** In certain countries, one-way messaging is **not** allowed.
{% endhint %}

<figure><img src="/files/0q3HDU73RgzbFs6LUet8" alt=""><figcaption></figcaption></figure>

### **Select number(s)**

If you've selected **two-way** communication, you must also:&#x20;

1. Select a long number/short code.
2. Add a new number or use an existing one.

{% hint style="info" %}
See [this section](/sms-channel/getting-started/add-and-edit-sms-numbers.md) of the guide for more details on SMS numbers.
{% endhint %}

{% hint style="warning" %}
Since short codes require an application process and are not available immediately, we recommend you [**apply for a short number** ](/sms-channel/short-codes.md)before adding a new SMS setup if you plan on using a short code for your SMS communications.
{% endhint %}

<figure><img src="/files/JqddDXm6uD9BjINoVplc" alt=""><figcaption></figcaption></figure>

### **Select the API type**

1. Choose between:
   * &#x20;*HTTP* (if you are using SMS as the **only** channel), or&#x20;
   * *One API* (for use with WhatsApp, SMS, and future channels)
2. Create a new API setup or link an existing one.

<figure><img src="/files/WxxCH3URgC3583DjYHJQ" alt=""><figcaption></figcaption></figure>

### **Set up API details (new API setups only)**

1. Enter a **name** for the API.
2. Select whether this must be added in the Sandbox (recommended) or Production **environment.**
3. Select a delivery option under *SMS Service Class*:
   * **Priority SMS delivery:** Our fastest and most direct line of delivery of time-sensitive SMS messages such as one-time PINs (OTPs) and transactional messages.&#x20;
     * *Not to be used for marketing or promotional notifications.*&#x20;
   * **Standard SMS delivery:** For high-quality, reliable SMS delivery of non-time-sensitive SMS messages such as marketing promotions, brand announcements, or CRM messages.&#x20;
4. Edit other **optional settings** (e.g., enabling message parts and configuring callbacks for delivery notifications) using the toggles.

<figure><img src="/files/iu7bR7hqg4Z3PeHntOYx" alt=""><figcaption></figcaption></figure>

### **Send test messages (optional)**

{% hint style="info" %}

* You can add a maximum of **two** test phones to your account.
* The number of free test SMS messages you can send per account is limited to **10** per day with an overall maximum of **100** per month.
* Test messages are always free, however, you need a positive account balance before you can send test messages.
* &#x20;You will be charged for messages sent once the integration is promoted to production.&#x20;
  {% endhint %}

Your API details are displayed.&#x20;

1. The **unique API key** is the authorization key required to interface with the Clickatell platform.
   * The API key is prepopulated in our example scripts that you can copy and paste.

<figure><img src="/files/xVXSSPnaLtnCsBaqP15x" alt=""><figcaption></figcaption></figure>

2. **Test** the sending/receiving of messages from the Sandbox environment by adding up to **three** [**test phone**](/sms-channel/getting-started/add-and-edit-test-phones.md) **numbers** to your account.&#x20;
3. Click *+ Add test phone* and follow the prompts.&#x20;

{% hint style="info" %}
Phone numbers must be entered in the **international format** and contain no spaces or other non-numeric characters.&#x20;
{% endhint %}

4. Click *Complete*.&#x20;
   * Your new SMS Setup is added to the [*My SMS Setups*](/sms-channel/getting-started/edit-and-test-sms-setups.md) table and is visible on the[ *API Integrations*](https://clickatell.gitbook.io/chat-commerce-platform/navigation-and-access/user-portal/view-and-edit-api-integrations) page.

<figure><img src="/files/jniCW7JXzySdEXOpAGBk" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.clickatell.com/sms-channel/getting-started/add-new-sms-setups-self-serve.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.