# 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="/files/VeXGB85ChYrll8qJNQ5x" 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="/files/jvemRCIt9TB1CmZq4DmM" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/CJ9wBZtcwP9jj3Hqcs2j" 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="/files/wIXQ1VLq9XQVVjPhxa9w" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/uIFb5j1QPE6tVmoMqoi6" 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="/files/BMcKPgRYs2SuM73al1NM" 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="/files/JD9QR2kMBTCcaJPfaCQx" 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="/files/hDOIz0WzaGGfI1dmjDyi" 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="/files/YfaNJDjb9Daw3BqVokuX" 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="/files/BMkuO0YwRs5oU3OP2J2q" 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.


---

# 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://docs.mydbsync.com/cloud-workflow/connectors/linnworks/creating-the-dbsync-application-on-linnworks-developer-instance.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.