> For the complete documentation index, see [llms.txt](https://help.delpha.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.delpha.io/delpha-for-salesforce/delpha-setup/install-delpha/connect-the-org-to-delpha.md).

# Connect the org to Delpha

Connect your Salesforce org to Delpha by using the Delpha Setup app and configuration tab. Fast integration in just a few clicks to enable full platform functionality.

## Connecting Your Salesforce Org to Delpha

From version 3.91 Delpha relies on an **External Connected App** to ensure the connection with Delpha backend. Complete the required setup steps as a Salesforce administrator to cope with Salesforce security recommendations.

### Step 1: Create a Delpha Integration profile.

* Navigate to Salesforce Setup > Users > **Profiles**
* Clone the **Standard User** profile and name it **Delpha Integration**.
* Edit the new profile and activate these 4 Administrative Permissions
  * **API Enabled**
  * **Customize Application**
  * **View All Data**
  * **View Setup and Configuration**

{% hint style="info" %}
You can use an existing profile, such as **System Administrator** or **Minimum Access - Salesforce**. Enable all four permissions directly on the profile, or assign them through a permission set. A permission set is required when using **Minimum Access - Salesforce**.
{% endhint %}

### Step 2: Authorize and setup the Delpha App

* Navigate to Salesforce Setup > **External Client App Manager**\
  You will see 2 ECA, installed by Delpha:
  * **Delpha\_Assistant\_Dev**: ensures the connection with Delpha Dev backend. Modify this ECA only if Delpha Support ask you so. It requires some extra settings to be activated by Delpha.
  * **Delpha\_Assistant\_Prod**: ensures the connection with Delpha Prod backend.
* Edit the policies of **Delpha\_Assistant\_Prod** and unfold the **OAuth Policies**.\
  Set **Permitted Users** to **Admin approved users are pre-authorized**\
  Save the changes.
* Edit the policies of **Delpha\_Assistant\_Prod** and unfold the **App Policies**.\
  In the Select Profile section, select **Delpha Integration** from the Available Profiles list and assign it to the **Selected Profiles** list.\
  Save the changes.

{% hint style="info" %}

* With this setup, only the users with the **Delpha Integration** profile can be set as Delpha Integration users.
* If you used an existing profile for step 1, you can limit the scope of allowed users by creating an empty permission set **Delpha Integration** and assign it in the Select Permission Sets section.
  {% endhint %}

### Step 3: Setup a Delpha Integration user and connect the org

The Delpha Integration user is acting on behalf of Delpha. Every change Delpha makes is attributed to the Delpha Integration user in the audit trail.

The active Salesforce User you want to assign as the Delpha Integration user must have:

* the profile defined as **Delpha Integration profile**
* the **Delpha User Permission Group** (or Delpha Data Steward or Delpha Admin)
* a **Delpha Licence**

To connect the org to the Delpha backend, open **Delpha Setup** app and start typing the name of the user in the dynamic edit field. Select the user when you see it in the list.

<figure><img src="https://2667079222-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYmkiQxbgPV34P1O0Qsq9%2Fuploads%2Fzc4ZF0AOnNlrseZgmF8h%2Fimage.png?alt=media&amp;token=76f76ccc-bff6-4afd-b617-aec8410cf942" alt=""><figcaption></figcaption></figure>

Once connected, Delpha can begin syncing data and enabling core features.

{% hint style="warning" %}
The profile and permissions of the Delpha Integration user are going to be used by Delpha to perform any needed modification. We recommend using a dedicated 'technical' user and to give the profile extended access to the objects.
{% endhint %}

{% hint style="success" %}
Delpha Technical Setup is done!
{% endhint %}


---

# 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.delpha.io/delpha-for-salesforce/delpha-setup/install-delpha/connect-the-org-to-delpha.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.