> For the complete documentation index, see [llms.txt](https://help.smallbuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smallbuilder.com/smallbuilder-line-items/getting-started/connected-app-setup.md).

# Connected App Setup

{% hint style="warning" %}
**From version 3.0, the Connected App has been replaced by the External Client App (ECA).**

If you are on version 3.0 or later, please refer to the [External Client App (ECA) Setup](/smallbuilder-line-items/getting-started/eca-setup.md) page. The instructions below apply to Connected App environments on versions earlier than 3.0.
{% endhint %}

To perform metadata-related tasks such as **adding buttons to page layouts or retrieving custom labels in the builder**, additional configurations for the connected app in SmallBuilder Line Items are required.

### Step 1: Configure Permitted Users <a href="#step-1-configure-permitted-users" id="step-1-configure-permitted-users"></a>

1. In **Setup**, enter Connected Apps in the Quick Find box and select **Manage Connected Apps**.
2. Click **Edit** for **SmallBuilder Line Items OAuth**.
3. Set **Permitted Users** to **Admin approved users are pre-authorized**.
4. Click **Save**.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2FyJPhxM767m1dBAa9fINO%2FConnectedApp03.png?alt=media&amp;token=58bf7a34-924b-4192-a621-f6c52f5c335d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fku0hdYfHa0m7oLMw5U2l%2FConnectedApp02.png?alt=media&amp;token=689e66e7-7f72-4ed1-8b52-563da75e595a" alt=""><figcaption></figcaption></figure>

### Step 2: Assign Profiles or Permission Sets <a href="#step-2-assign-profiles-or-permission-sets" id="step-2-assign-profiles-or-permission-sets"></a>

1. In **Setup**, enter Connected Apps in the Quick Find box and select **Manage Connected Apps**.
2. Click **SmallBuilder Line Items OAuth**.
3. At the bottom, click **Manage Profiles** or **Manage Permission Sets**.
4. Select the profile or permission set responsible for **configuring the product using the builder**.
5. Click **Save**.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fv0gUsztZ9ZEDJcP4XRTz%2FConnectedApp01.png?alt=media&amp;token=cc802d60-ee24-48fb-bdf8-37edc343a6e6" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2F69nhY0ngoZIuWqPogC2X%2FConnectedApp04.png?alt=media&amp;token=b85e049c-48a5-486f-b748-3c934f47875a" alt=""><figcaption></figcaption></figure>
