# 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="https://content.gitbook.com/content/jwheCD9pTTjLMKBa0X5e/blobs/x0HsIHmy08RgIPQ2UzVe/image.png" 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**](https://guides.clickatell.com/sms-channel/1-way-sms-communication) (sending only) or [**2-way**](https://guides.clickatell.com/sms-channel/2-way-sms-communication) (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](https://guides.clickatell.com/sms-channel/getting-started/add-new-sms-setups-self-serve/add-campaign-manager).

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

<figure><img src="https://content.gitbook.com/content/jwheCD9pTTjLMKBa0X5e/blobs/2dmx7dYMdOavuIwzBCPJ/image.png" 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](https://guides.clickatell.com/sms-channel/getting-started/add-and-edit-sms-numbers) 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** ](https://guides.clickatell.com/sms-channel/short-codes)before adding a new SMS setup if you plan on using a short code for your SMS communications.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/jwheCD9pTTjLMKBa0X5e/blobs/caKioVywgyXdW44iGMBP/image.png" 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="https://content.gitbook.com/content/jwheCD9pTTjLMKBa0X5e/blobs/p8e4yyr3jzpDfgEUtwu2/image.png" 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="https://content.gitbook.com/content/jwheCD9pTTjLMKBa0X5e/blobs/fAtCwvhKdXTHniXj0SaZ/image.png" 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="https://content.gitbook.com/content/jwheCD9pTTjLMKBa0X5e/blobs/0GIzHRUdRERBxhn9VayD/image.png" alt=""><figcaption></figcaption></figure>

2. **Test** the sending/receiving of messages from the Sandbox environment by adding up to **three** [**test phone**](https://guides.clickatell.com/sms-channel/getting-started/add-and-edit-test-phones) **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*](https://guides.clickatell.com/sms-channel/getting-started/edit-and-test-sms-setups) 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="https://content.gitbook.com/content/jwheCD9pTTjLMKBa0X5e/blobs/r63vuEB94g5MjSef204B/image.png" alt=""><figcaption></figcaption></figure>