# Add new Connected App - Salesforce

{% hint style="success" %}
If you’ve already set up a Connected App for your integration with Clickatell, you can log in to Salesforce and [follow these steps](/integrations/salesforce/find-configuration-details-salesforce.md) to find the required integration details.
{% endhint %}

To [integrate ](/integrations/getting-started/adding-a-new-integration.md)with Salesforce, you need to copy over the **Client ID** and **Client Secret** from Salesforce into the Clickatell Portal. These are unique and get generated when you add a new Connected App in Salesforce. 

## Create a new Connected App in Salesforce 

{% hint style="info" %}
Salesforce is very customizable. The screen in your account might differ slightly from the one in these screenshots.
{% endhint %}

{% hint style="warning" %}
You need Salesforce Admin credentials to create a connected app. 
{% endhint %}

1. Log in to your Salesforce account.
2. Go to *Settings -> Setup.*

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

3. Search for “App Manager” and click *New Connected App.*

{% hint style="info" %}
If you do not see App Manager as an option, please ask your Salesforce Admin to follow the steps in this document and provide the details you require for the setup in the Clickatell Portal.
{% endhint %}

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

4. Complete the first three required fields. *(You can also complete other optional fields.)*
   * **Connected App Name:** Give any name to your new connected app in Salesforce.
   * **API Name:** This automatically populates based on what you’ve entered above.
   * **Contact email:** Enter an email where you can be contacted and where the OTP will be sent.

<figure><img src="/files/VNT5dHQqpk8IaiECpoP3" alt="" width="563"><figcaption></figcaption></figure>

5. Select “*Enable OAuth Settings*”.
6. Add the callback URL: <https://auth.clickatell.com/authorize/result>
7. Add the following scopes:&#x20;
   * *Full access (full)*
   * *Mange user data via APIs (api)*
   * *Perform requests at any time (refresh\_token, offline\_access)*

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

8. Ensure this first item is **not** checked:

<figure><img src="/files/AHHRUpQkEUgpS4WAxggF" alt="" width="373"><figcaption></figcaption></figure>

9. Click *Save* at the bottom of the page.
10. Continue to the next page and click *Manage Consumer Details*.

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

11. Enter the verification code that is emailed to you and click *Verify*.

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

12. The [configuration details required](/integrations/salesforce/find-configuration-details-salesforce.md) in the Clickatell Portal are displayed.&#x20;

<figure><img src="/files/4ZgIZM6GU4UHn1N972D1" 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/salesforce/add-new-connected-app-salesforce.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.