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.
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
Sign in to Fulfil and go to https://auth.fulfil.io/user/clients.
Create a new client / OAuth application.
Give the app a name - e.g.
Purple Dot.Set the Redirect URL to:
Copy this URL exactly - it must match character for character, or authorization will fail.
Save the app.
Step 3: Copy your Client ID and Client Secret
After saving, Fulfil displays a Client ID and Client Secret.
Step 4: Connect in Purple Dot
In the Purple Dot merchant portal, go to Settings → Integrations.
Find 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
Part B - Authorize in Fulfil
When ready, click Finish set-up.
You will be redirected to Fulfil to authorize the Purple Dot app.
Approve the requested permissions, click Allow.
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.
Last updated