> For the complete documentation index, see [llms.txt](https://docs.getpurpledot.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getpurpledot.com/docs/shopify-stores/pre-order-automation/fulfil.io.md).

# Fulfil.io

Purple Dot can connect to your Fulfil account to power pre-order automation - matching incoming stock to your Shopify catalog and creating Waitlists from expected delivery dates.

This guide walks through creating an OAuth app in Fulfil, then connecting it to the Purple Dot [Merchant Portal](https://www.purpledotprice.com/merchant-portal/integration).

#### **Before you start**

You will need:

* Access to your **Fulfil** account with permission to create OAuth applications (Settings → API / Developer access)
* Access to the Purple Dot **merchant portal** (Settings → Integrations)

Allow 10–15 minutes for the full setup.

#### **Step 1: Find your workspace**

Your workspace is the subdomain in your Fulfil URL.

**Example:** if you sign in at `https://acme.fulfil.io`, your workspace is `acme`.

You will enter this when connecting in Purple Dot.

#### **Step 2: Create an OAuth app in Fulfil**

1. Sign in to Fulfil and go to <https://auth.fulfil.io/user/clients>.
2. Create a new client / OAuth application.
3. Give the app a **name** - e.g. `Purple Dot`.
4. Set the **Redirect URL** to:

```
<https://www.purpledotprice.com/merchant-portal/connections/fulfilio/callback>
```

Copy this URL **exactly** - it must match character for character, or authorization will fail.

1. Save the app.

<figure><img src="/files/MGrutO9KejqxmfAW7PM5" alt=""><figcaption></figcaption></figure>

#### **Step 3: Copy your Client ID and Client Secret**

After saving, Fulfil displays a **Client ID** and **Client Secret**.

<figure><img src="/files/nODTfOeUM3M5JExA9mvT" alt=""><figcaption></figcaption></figure>

#### **Step 4: Connect in Purple Dot**

1. In the Purple Dot merchant portal, go to **Settings → Integrations**.
2. Find [**Fulfil.io**](http://Fulfil.io) and click **Connect**.

**Part A - Enter your details**

In the connect modal:

* **Workspace** - from Step 1 (e.g. `acme`)
* **Client ID** - from Step 3
* **Client Secret** - from Step 3
* Click **Connect**

<figure><img src="/files/bup9R4iq58hwf3sknJys" alt=""><figcaption></figcaption></figure>

**Part B - Authorize in Fulfil**

1. When ready, click **Finish set-up**.
2. You will be redirected to Fulfil to authorize the Purple Dot app.
3. Approve the requested permissions, click **Allow**.
4. You will be returned to Purple Dot. Fulfil should now appear under your live integrations.

#### **What happens after you connect**

Once connected, Purple Dot can:

* Read your incoming purchase-order and transfer shipments - including SKUs, quantities, locations, and expected delivery dates - to draft Waitlists automatically.
* Match your Fulfil products and sales orders to your Shopify catalog and orders.

Purple Dot uses a single Fulfil connection for both reading data (pre-order automation) and managing shipments (native fulfillment). Here's why each permission is needed.

#### **Troubleshooting**

| **Problem**                        | **What to try**                                                                                                                      |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Authorization fails immediately    | Check that the Redirect URL in Fulfil matches `https://www.purpledotprice.com/merchant-portal/connections/fulfilio/callback` exactly |
| Connection rejected after allowing | You may have unchecked one or more permissions on the consent screen. Start over and leave all permissions enabled                   |
| "Invalid client" or similar        | Double-check the Client ID and Client Secret were copied correctly, with no extra spaces                                             |
| Lost your Client Secret            | Regenerate credentials in Fulfil, then update the Client ID and Secret in Purple Dot                                                 |
| Wrong workspace                    | Confirm the workspace subdomain from your Fulfil login URL (the part before `.fulfil.io`)                                            |

***

If you get stuck, contact Purple Dot support with your workspace and a description of where the setup failed.