# 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>


---

# 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://help.clickatell.com/integrations/getting-started/adding-a-new-integration.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.