# 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](https://guides.clickatell.com/integrations/salesforce/find-configuration-details-salesforce)
  * [Shopify](https://guides.clickatell.com/integrations/shopify/find-configuration-details-shopify)
  * [Zendesk Sell](https://guides.clickatell.com/integrations/zendesk-sell/find-configuration-details-zendesk-sell)
  * [Zendesk Support](https://guides.clickatell.com/integrations/zendesk-support/find-configuration-details-zendesk-support)
    {% 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="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/X15JHlZPfO2jZBS1aJx1/image.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/VrB10zUJLI4SIqdt080C/image.png" 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="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/NcXGNYoSZRtoV1ZOn7Ui/image.png" 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="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/jRvgG2F7G7EriRdxCI62/image.png" 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="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/aFkGAWApsgGHdz8ITUC0/image.png" 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="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/aMq2RiWXeUpBVCR29WLA/image.png" alt=""><figcaption></figcaption></figure>