> For the complete documentation index, see [llms.txt](https://help.clickatell.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.clickatell.com/integrations/getting-started/adding-a-new-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.