> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Developer Account

> Set up your development environment in three connected steps. Takes about 10 minutes.

To build on the JTL platform, you'll work across four connected environments. Each one plays a different role in your development workflow. Three of them are needed to start building, and the fourth comes in when you're ready to test your app.

This guide walks you through setting them up in one go. It takes about 10 minutes.

## Your Development Environment

Here's what each environment does and why you need it:

| Environment                                                  | What you'll use it for                                                                                                                                                                                                                           |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **[JTL-Wawi](/guides/erp-integration/integration-overview)** | The ERP system where merchant data lives: products, orders, customers, inventory. Your app reads and writes this data through APIs or GraphQL.                                                                                                   |
| **[Partner Portal](https://partner.jtl-cloud.com/)**         | Where you create and manage your apps.                                                                                                                                                                                                           |
| **[JTL Hub](https://hub.jtl-cloud.com/)**                    | A dedicated environment where you can install and test your apps, verify the connection to JTL-Wawi, and manage the app lifecycle before going live.                                                                                             |
| **[ERP Cloud](https://erp.jtl-cloud.com/)**                  | The web-based interface where your installed app actually runs. Currently in development, with MVP release coming soon. You can already use it to test your app and validate how it integrates. See [Test your App](/get-started/test-your-app). |

<Note>
  **JTL-Wawi** is the ERP itself (the data), **Partner Portal** is where you
  create and manage your apps, **JTL Hub** is where you install, and **ERP
  Cloud** is where your app runs for the merchant.
</Note>

Here's how they connect:

```mermaid theme={null}
flowchart LR
    subgraph You["👤 Developer"]
        direction TB
    end

    subgraph Create["1 · Partner Portal"]
        direction TB
        PP["**Create & configure apps**
        Manage credentials
        Handle submissions & payouts"]
    end

    subgraph Install["2 · JTL Hub"]
        direction TB
        HC["**Sandbox environment**
        Install & test apps
        Manage app lifecycle"]
    end

    subgraph Run["3 · ERP Cloud"]
        direction TB
        EP["**App runtime**
        Where your installed
        app actually renders"]
    end

    subgraph Data["JTL-Wawi"]
        direction TB
        WW["**ERP system**
        Products, orders, customers, inventory & shipping"]
    end

    subgraph Ship["🚀 App Store"]
        direction TB
        ES["Distribute to 50,000+ merchants"]
    end

    You --> Create
    Create -- "App credentials" --> Install
    Install -- "Launches app" --> Run
    Run -- "APIs" --> Data
    Install -- "Submit" --> Ship

    style Create fill:#FFF2EB,stroke:#FB581F,stroke-width:2px,color:#0B1B45
    style Install fill:#E8F4FF,stroke:#89D2FF,stroke-width:2px,color:#0B1B45
    style Run fill:#E8F4FF,stroke:#89D2FF,stroke-width:2px,color:#0B1B45
    style Data fill:#FFF2EB,stroke:#FB581F,stroke-width:2px,color:#0B1B45
    style Ship fill:#FFF2EB,stroke:#FB581F,stroke-width:2px,color:#0B1B45
    style You fill:#EEEEE7,stroke:#0B1B45,stroke-width:2px,color:#0B1B45
```

The overall flow is: you **create your app** in the Partner Portal, **install it** in JTL Hub, **run it** in the ERP Cloud against **live data from JTL-Wawi**, and when everything looks good, **submit it** to the App Store.

Now let's get everything set up.

## Step 1: Set up your Partner Portal

This is your app management hub where you create apps and get your client credentials.

<Steps>
  <Step title="Go to the Partner Portal">
    Open [Partner Portal](https://partner.jtl-cloud.com/) in your browser.
  </Step>

  <Step title="Create your JTL ID">
    <Warning>
      SSO is currently not supported with your JTL ID. You'll need to register separately with your email.
    </Warning>

    Once you navigate to the URL, you'll be prompted to log in with your **JTL ID**. Click on the **Register now** button to create a new JTL ID.

    **JTL ID** provides a single access point to all JTL cloud-related services (JTL Hub, Partner Portal, ERP Cloud, etc.)

    <img src="https://mintcdn.com/jtlsoftwaregmbh/qgD5xQkqMP8uX3uJ/images/Partner_JTL_register.png?fit=max&auto=format&n=qgD5xQkqMP8uX3uJ&q=85&s=1376ea269fb72439d6fd7263f9df84dd" alt="Partner Portal registration screenshot" width="2862" height="1634" data-path="images/Partner_JTL_register.png" />

    On registering, you'll be asked to fill in the confirmation code sent to your email address. Once you fill in the code, you'll be redirected to the log in page.
  </Step>

  <Step title="Log in and Create a Customer Center Account">
    Once you log in with your credentials, choose one of the following:

    <img src="https://mintcdn.com/jtlsoftwaregmbh/tc1cE5xD4x4xc5-N/images/create_or_link.png?fit=max&auto=format&n=tc1cE5xD4x4xc5-N&q=85&s=a8e2f486e5124de0e0b3692210eb0e4b" alt="Create or link customer account" width="2930" height="1740" data-path="images/create_or_link.png" />

    * **New to JTL**: Click **Create organization** and fill in the required details if you don't have an existing Customer Center Account.
    * **Existing JTL customer**: Click **Link your JTL customer account** and log in to your Customer Center Account. Then **Authorize** JTL Cloud when prompted.

    <Tip>
      **Customer Center Account** is your central hub for managing licenses, JTL
      services, billing, and support.
    </Tip>

    After completing either option above, continue with the steps below:

    1. Once your organization is created, you’ll see your organization name and custom URL path.

           <img src="https://mintcdn.com/jtlsoftwaregmbh/tc1cE5xD4x4xc5-N/images/org_created.png?fit=max&auto=format&n=tc1cE5xD4x4xc5-N&q=85&s=d8feba9581f55db7119038d733162552" alt="Organization created" width="3070" height="1838" data-path="images/org_created.png" />

    2. Click **Continue to JTL Hub** and you’ll be redirected to [JTL Hub dashboard](https://hub.jtl-cloud.com/).

           <img src="https://mintcdn.com/jtlsoftwaregmbh/tc1cE5xD4x4xc5-N/images/continue_to_JTL_hub.png?fit=max&auto=format&n=tc1cE5xD4x4xc5-N&q=85&s=d0a31f185e143a86c6ba2300b090d596" alt="Continue to JTL Hub" width="2844" height="1678" data-path="images/continue_to_JTL_hub.png" />

       <Tip>It’s recommended to set up 2FA before proceeding.</Tip>

    3. On your JTL Hub dashboard, click the [Partner Portal](https://partner.jtl-cloud.com/) link.

           <img src="https://mintcdn.com/jtlsoftwaregmbh/tc1cE5xD4x4xc5-N/images/partner_portal_link.png?fit=max&auto=format&n=tc1cE5xD4x4xc5-N&q=85&s=885c8b2479722e4cdf52cc14d2642199" alt="Partner Portal link" width="3054" height="1686" data-path="images/partner_portal_link.png" />

       You’ll be redirected to the Partner Portal domain. Click **Create an account**.

       Next, select how you want to use the Partner Portal and then **Continue**.

           <img src="https://mintcdn.com/jtlsoftwaregmbh/tc1cE5xD4x4xc5-N/images/Partner_JTL_how_to_use.png?fit=max&auto=format&n=tc1cE5xD4x4xc5-N&q=85&s=134af50691126d81eea9022deece1b23" alt="How to use Partner Portal" width="2744" height="1580" data-path="images/Partner_JTL_how_to_use.png" />

    4. Enter your business contact details and **Create account**.

           <img src="https://mintcdn.com/jtlsoftwaregmbh/tc1cE5xD4x4xc5-N/images/business_contact_details.png?fit=max&auto=format&n=tc1cE5xD4x4xc5-N&q=85&s=b88237395ea1122622cc6ee573e46b11" alt="Business contact details" width="2642" height="1676" data-path="images/business_contact_details.png" />

       Once your account is created, you’ll be redirected to the Partner Portal dashboard. This is where you'll create and manage your apps.

           <img src="https://mintcdn.com/jtlsoftwaregmbh/tc1cE5xD4x4xc5-N/images/partner_portal_dashboard.png?fit=max&auto=format&n=tc1cE5xD4x4xc5-N&q=85&s=98bef69170a4ded816d839e2e6751c3d" alt="Partner Portal dashboard" width="2748" height="1332" data-path="images/partner_portal_dashboard.png" />
  </Step>
</Steps>

## Step 2: Connect to JTL-Wawi

The final step is to connect your JTL Cloud environment to JTL-Wawi. Your app uses this connection to read and write merchant data.

<Steps>
  <Step title="Initiate connection from JTL-Wawi">
    Log in to your JTL-Wawi instance.

    In the **Admin** menu, click **JTL Cloud**, then click **Connect**.

    <img src="https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/JTL_cloud_connect.png?fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=51778be86b276762d47119f8f83501eb" alt="JTL Cloud > Connect option" data-og-width="1768" width="1768" data-og-height="876" height="876" data-path="images/JTL_cloud_connect.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/JTL_cloud_connect.png?w=280&fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=93e06fdcc0f256ccb9b7f01f51daa1bd 280w, https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/JTL_cloud_connect.png?w=560&fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=b29dc5f8451eb165665f3b007405922f 560w, https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/JTL_cloud_connect.png?w=840&fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=dfd44063d1d1ab1fd57cd3e81e189e81 840w, https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/JTL_cloud_connect.png?w=1100&fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=75cadf80723f8c7bfd218941a985c7d7 1100w, https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/JTL_cloud_connect.png?w=1650&fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=8e33bfcd11b7be73710b17d6d8279637 1650w, https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/JTL_cloud_connect.png?w=2500&fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=cba30ef392eba916931d976a57ea63e2 2500w" />

    Read the message in the dialog carefully and click **OK**. This opens a new tab with the JTL Cloud login page.
  </Step>

  <Step title="Log in to JTL Cloud">
    Log in using the JTL ID you created in [Step 1](#step-1-set-up-your-partner-portal).

    Once authentication is successful, close the browser tab and return to your JTL-Wawi instance.
  </Step>

  <Step title="Confirm connection status">
    Back in JTL-Wawi, you'll see a **Connected** status, indicating the pairing was successful.

    <img src="https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/JTL_connection_statuses.png?fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=9599320f8ddd2b13a693ef218072489a" alt="Connected Wawi instance" width="1770" height="880" data-path="images/JTL_connection_statuses.png" />
  </Step>

  <Step title="Start the Wawi API">
    Pairing JTL-Wawi with JTL Cloud is not sufficient on its own. You must also configure and start the Wawi API so your app can access and sync data.

    Open the **JTL Administrator** to start the Wawi API.

    <Info>
      JTL creates a desktop shortcut for the JTL Administrator after installation.\
      For older versions of JTL-Wawi, you can find it in the installation folder.
    </Info>

    Create a new entry by selecting **Wawi-API**.

    <img src="https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/admin_wawi_api.png?fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=ecb9ad4dcc5e098c50ba61049395f475" alt="Create new API entry" width="1576" height="896" data-path="images/admin_wawi_api.png" />

    Select the desired profile and certificate, then enable the **Cloud Connection** checkbox.

    Click **Save**.

    <img src="https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/wawi_api_form.png?fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=dff3c6ccc596d46c7e3dc78fe52f85df" alt="Cloud Connection via JTL Administrator" width="1192" height="1090" data-path="images/wawi_api_form.png" />

    Once the connection is established, you will see an **is running** status. This may take a few seconds.

    <img src="https://mintcdn.com/jtlsoftwaregmbh/_2ZZJDr-y_bgfn7P/images/connected_wawi_to_cloud.png?fit=max&auto=format&n=_2ZZJDr-y_bgfn7P&q=85&s=e7a7767f87390ec6d8b75cfed0ce3f47" alt="Connected Wawi instance" width="1600" height="896" data-path="images/connected_wawi_to_cloud.png" />

    You can start or stop the API service from the JTL Administrator.

    <Warning>
      If the API service is stopped, Cloud Apps cannot read or write data.
    </Warning>
  </Step>

  <Step title="Verify in JTL Hub">
    Navigate to the **Connection (JTL-Wawi)** menu in JTL Hub to see your connected Wawi instance.

    <img src="https://mintcdn.com/jtlsoftwaregmbh/pWFre2usvM9pSHTY/images/connected_wawi.png?fit=max&auto=format&n=pWFre2usvM9pSHTY&q=85&s=5e261d4634af53008c20746a3a9f644b" alt="Connected Wawi instance" width="3222" height="1368" data-path="images/connected_wawi.png" />
  </Step>
</Steps>

You now have everything you need to start building Cloud Apps.

## What's Next?

<CardGroup cols={2}>
  <Card title="Quickstart: From Template" icon="copy" href="/get-started/quick-start/from-template">
    Start from a template and get a Cloud App running in minutes. Recommended for most developers.
  </Card>

  <Card title="Quickstart: From Scratch" icon="hammer" href="/get-started/quick-start/from-scratch">
    Build a Cloud App step by step to understand how everything fits together.
  </Card>
</CardGroup>

<Note>
  **Need help?** If you run into issues during account setup, reach out via the [support channel](/help/support).
</Note>
