# EasyEcom setup: prepare credentials and connect from Optiply

EasyEcom setup uses **Email**, **Password**, **Location Key** and **X-API-KEY**. Prepare them for the intended account and location, then connect from Optiply.

## Before you connect EasyEcom

Open the intended Optiply account. Confirm the EasyEcom location and data flows with your administrator before entering credentials.

You need access to the primary seller account to generate **X-API-KEY**. Keep passwords and keys out of ordinary support messages and screenshots.

Use the [EasyEcom mapping guide](/article/integrations-data-mappings-public-easyecom) to check which records and fields your workflow needs.

## Steps to connect EasyEcom

### Prepare credentials in EasyEcom

1. Sign in to your EasyEcom primary seller account.
2. Open **Account Settings → Change credentials**.
3. Under **X-API-KEY**, select **Generate X-API-KEY**.
4. Store the generated key securely.
5. Open **Location Master** in the primary account.
6. Identify the Location Key for your intended location.
7. Prepare the registered EasyEcom email and password for the connection.

The API key and Location Key serve different purposes. EasyEcom requires the API key for authorization, while the Location Key identifies the location.

The [official EasyEcom API documentation](https://api-docs.easyecom.io/) explains these credential sources and API limits. A new API key starts in the default tier. Ask Support to coordinate any production-access review with EasyEcom.

### Select EasyEcom in Optiply

1. Open **Settings → Integrations**.
2. Wait for the source lists to load.
3. Select **Add a source**.
4. Search for **EasyEcom** in **Select a source**.
5. Select **EasyEcom** under **WMS & Fulfillment**.
6. Select **Next**.

![Search for EasyEcom in the source-selection dialog.](/screenshots/easyecom/select-source.webp)

### Complete the offered connection path

1. Enter the four requested credentials in **Connect to system**.
2. Choose **Connect** when the form allows it.
3. Follow any further authorization instructions shown.
4. Return to **Settings → Integrations**.
5. Check the intended source for **Connected**.
6. Compare an agreed product or order in both systems.

If **Contact us** appears instead of the credential form, request setup assistance through that control. This can also happen at the account's integration limit.

![EasyEcom connection form with credential values hidden.](/screenshots/easyecom/connection-form.webp)

Do not copy the example or placeholder text from the screenshots.

## Fields in the EasyEcom connection form

| Field or control | What you enter or check |
| --- | --- |
| **Email** | Registered EasyEcom email for the connection |
| **Password** | Matching EasyEcom password |
| **Location Key** | Key for the intended location, from Location Master |
| **X-API-KEY** | API key generated from the primary seller account |
| **Connect** | Submit the valid connection form |
| **Contact us** | Request assistance when offered |
| **Connected** | Linked source, not confirmation of record transfer |

## What you see when EasyEcom setup worked

The intended source appears as **Connected** when linking succeeds. Connected is not proof that records transferred. Check the agreed records separately before using the data for planning.

## Limits of EasyEcom setup

Account access, available connectors and authorization screens depend on your account. The screenshots show the form, not a successful connection.

API limits and enabled flows affect data arrival. Setup does not assign a fixed first-transfer time.

## If EasyEcom setup did not work

- Missing source or different fields: contact [Optiply Support](/support) with the connector name and screen description.
- Disabled **Connect** or failed authorization: verify **Email**, **Password**, **Location Key** and **X-API-KEY** for the intended account and location.
- Missing primary-account access: ask your EasyEcom administrator to prepare the key.
- API-limit error or absent data: ask Support to check API access and record transfer separately.

Tell Support the intended location, required flows, screen and error message without credentials. Ask for the secure setup route when credentials need review.

## Related articles on EasyEcom and integrations

- [EasyEcom data mapping](/article/integrations-data-mappings-public-easyecom)
- [Custom and partner integrations](/article/custom-and-partner-integrations)
