# Creating the DBsync Application on Linnworks Developer Instance

## Introduction

This guide walks you through the process of creating a custom **DBSync application within the Linnworks Developer Portal**. By following the steps outlined below, you will be able to register an integration app that can interact with Linnworks APIs and support synchronization with DBSync workflows.

## **Step-by-Step Instructions**

#### **Step 1: Navigate to the Applications Section**

1. Log in to your Linnworks developer account.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FJ2OPkjzMueDxk6sO49WB%2FCreating%20DBSync%20Application%20in%20Linnworks0.png?alt=media&#x26;token=9b834bdd-b204-4ac8-9ae5-692d0d418f10" alt=""><figcaption></figcaption></figure>

2. From the left-hand navigation panel, click on **Applications**.
3. On the top-right corner of the Applications page, click **`+ New App`**.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FMUXiXOiJlOnlC4MNnUNq%2FCreating%20DBSync%20Application%20in%20Linnworks.png?alt=media&#x26;token=b7baa8bd-fb60-4f6a-b282-5429c4cf5ba8" alt=""><figcaption></figcaption></figure>

#### **Step 2: Enter Basic Application Information**

4. A popup titled **New Application** will appear.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FVJBI2V7RW6nLdBxK7ySe%2FCreating%20DBSync%20Application%20in%20Linnworks1.png?alt=media&#x26;token=1c1ceec7-3835-4766-bb61-1503469c2df0" alt=""><figcaption></figcaption></figure>

5. In the **Name** field, enter a name for your application (e.g., `DBSync Integration`).
6. In the **Application Type** dropdown, select `System Integration` from the list of application types.&#x20;

{% hint style="info" %}
**NOTE:** This option is suitable for back-end server integrations like DBSync.
{% endhint %}

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FUfx5Z2uZ0jWc41P8QDUC%2FCreating%20DBSync%20Application%20in%20Linnworks2.png?alt=media&#x26;token=79d2fbad-e988-4fb0-a9b2-d8a66e6c5dd7" alt=""><figcaption></figcaption></figure>

7. Click the **Create** button to save and generate your application instance.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FxIYczATmojsxuJY9S9p7%2FCreating%20DBSync%20Application%20in%20Linnworks3.png?alt=media&#x26;token=6dab07cd-e7fe-48ce-8771-517bc1b64ba8" alt=""><figcaption></figcaption></figure>

### **Configuring the DBSync Application**

Once the application is created, it will appear in your application list.&#x20;

1. Click on **Edit** provided for the application to configure its settings.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FeqSqMYFe58a9IqVa61eu%2FCreating%20DBSync%20Application%20in%20Linnworks4.png?alt=media&#x26;token=5823ff2f-beff-4027-8372-ed3004ca4e5e" alt=""><figcaption></figcaption></figure>

#### Step 1: Fill in General Application Details&#x20;

2. In the **General** section, enter:

* **Application Website:** your DBSync documentation or product URL
* **Summary:** a brief description of what the app does
* **Description:** a more detailed explanation of its integration capabilities

3. The **Application ID** and **Application Secret** will be generated automatically and can be used later in the OAuth configuration within DBSync Cloud Workflow platform.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FutzVKdS47Z6NdFhzHc40%2FCreating%20DBSync%20Application%20in%20Linnworks5.png?alt=media&#x26;token=7d2f8102-0fd4-430a-a69e-c6a0b3c0d45c" alt=""><figcaption></figcaption></figure>

#### **Step 2: Define App Modules and Permissions**

4. Go to the **App Modules** tab.
5. Under **Modules**, click **Add Module** and provide:

* **Module Name** (e.g., `Production`)
* **Formatted Name**, **Type**, and **Path** (as applicable)

6. Set the module **Type** to `External Application`.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FZYN1YVyIiLH9jYgF9uGS%2FCreating%20DBSync%20Application%20in%20Linnworks6.png?alt=media&#x26;token=8320a15e-9cc1-479a-b100-37c8557cb3be" alt=""><figcaption></figcaption></figure>

#### **Step 3: Assign Required Permissions**

7. Click the **Add** button in the **Permissions** section.
8. From the dropdown, select appropriate API scopes required for the integration.

* For example: `Change stock levels (GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockLevelsNode)`

9. Add any additional scopes based on the data you plan to access.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FnpJ6mVUhV9O5FTtMRiCF%2FCreating%20DBSync%20Application%20in%20Linnworks7.png?alt=media&#x26;token=5d8828e2-3873-4305-9a30-0d3ff7862789" alt=""><figcaption></figcaption></figure>

#### **Step 4: Review Module Type and Finalize**

10. Confirm that the **Type** of the module remains set to `External Application`.
11. Add any **scripts**, **styles**, or **parameters** if required by your implementation.
12. Click **Save Manifest** to apply your changes.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FTWLB1kLx8Ro6zY5g8fhi%2FCreating%20DBSync%20Application%20in%20Linnworks8.png?alt=media&#x26;token=43afed2b-650d-4eb2-9a21-b5da0d7e8313" alt=""><figcaption></figcaption></figure>

### **Next Steps**

Once the application is created and configured:

* Use the **Application ID** and **Secret** in DBSync to authenticate the Linnworks connector.
* Proceed to create and schedule your integration workflows.
