# 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](https://guides.clickatell.com/integrations/salesforce/find-configuration-details-salesforce) to find the required integration details.
{% endhint %}

To [integrate ](https://guides.clickatell.com/integrations/getting-started/adding-a-new-integration)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.&#x20;

## Create a new Connected App in Salesforce&#x20;

{% 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.&#x20;
{% endhint %}

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

<figure><img src="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/biVBORNylpBwbhvVBaP1/image.png" 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="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/AL4rYCW5lHXPW5ep34ud/image.png" 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="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/xKcdc4eXRU5j6zW5rWqt/image.png" 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="https://4215128416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxcMbyh2AMn0FTzC5pCX6%2Fuploads%2Fs3VbFKQTUyTXmwqouGGu%2Fimage.png?alt=media&#x26;token=4bdee677-7ac7-41af-9b5d-beafc89a0c66" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4215128416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxcMbyh2AMn0FTzC5pCX6%2Fuploads%2FPvPnY5HG0n9VAK4Tgs7A%2Fimage.png?alt=media&#x26;token=cc58516f-d89a-4eda-83e1-12cd765270c5" 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="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/sDzfF8MiYXVnpmgErWjj/image.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/fBwZJ6Yxy3hzMFpeKmLf/image.png" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/xcMbyh2AMn0FTzC5pCX6/blobs/Z4Kd6LREsi75TSkdepEB/image.png" alt=""><figcaption></figcaption></figure>
