> For the complete documentation index, see [llms.txt](https://guides.clickatell.com/integrations/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.clickatell.com/integrations/getting-started/adding-a-new-integration.md).

# Adding a new integration

{% hint style="success" %}
**Prerequisites for adding an integration:**

* An active subscription with the 3rd-party app and admin login credentials.
* You need to create an authentication app in the 3rd-party apps. Find how to create an authentication application in various 3rd-party apps here:
  * [Salesforce](/integrations/salesforce/find-configuration-details-salesforce.md)
  * [Shopify](/integrations/shopify/find-configuration-details-shopify.md)
  * [Zendesk Sell](/integrations/zendesk-sell/find-configuration-details-zendesk-sell.md)
  * [Zendesk Support](/integrations/zendesk-support/find-configuration-details-zendesk-support.md)
    {% endhint %}

### Add new integration

1. In the Clickatell Portal, go to *My Workspace -> Integrations.*
2. Select the 3rd-party app that you want to integrate with.

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

3. On the selected app’s page, click *Add Integration.*

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

4. Add a new production configuration or sandbox configuration (for testing).&#x20;
   * You can add as many configurations as you wish.

{% hint style="info" %}
You cannot promote a sandbox configuration directly into production. You must create a separate production configuration.&#x20;
{% endhint %}

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

5. Complete the required integration details.
6. Click *Activate*.

{% hint style="warning" %}
Note: For Zendesk Sell, ensure you are logged in to your Zendesk Sell account before clicking '*Activate*'.
{% endhint %}

{% hint style="info" %}
To find the information required here, see the relevant pages for each 3rd-party app in this guide.
{% endhint %}

<figure><img src="/files/6g66x1r7gPlZ7VCxI9cD" alt=""><figcaption></figcaption></figure>

7. Based on the information you entered, you are redirected to the 3rd-party app’s login screen to authenticate yourself.&#x20;
8. Sign in with your existing credentials for this app&#x20;
   * E.g., if it is Zendesk Support, sign in with your Zendesk Support account details; if it is Shopify, sign in with your Shopify account details).&#x20;

<figure><img src="/files/DrmAKcCJeOEklxlPqOQs" alt="" width="375"><figcaption></figcaption></figure>

9. Once you’ve successfully signed in, you are redirected back to the app’s page in the Clickatell Portal.&#x20;
10. The integration you’ve just added is shown with an "Active" status.&#x20;

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