Headless Configuration

Headless configuration allows your mobile app to connect directly with Shopify Customer Account API, enabling passwordless login (OTP / magic link). This helps reduce friction and improve conversion rates.

Before getting started, make sure:

• Your store is using Customer Accounts (New version)

• You have Admin access to the Shopify store

• You can access the Ego Mobile Builder Dashboard

Step 1: Enable Headless in Shopify

1. Go to Shopify App Store

2. Install Headless

👉 If you don’t see this option, your store may not support it or Customer Accounts (new version) is not enabled.

Step 2: Create Storefront API

1. In the Headless page

2. Click Create Storefront

✅ Result:

• A Storefront API is created for your mobile app connection

Step 3: Access Customer Account API

1. In the Headless page

2. Locate Customer Account API

3. Click Manage

Step 4: Configure Client Type

1. In the Customer Account API settings:

2. Select Client type = Confidential

1. In Application setup, locate Callback URI(s) (required)

2. Add the following URL:

https://mobile.opusecom.co/api/v1/auth-store/callback

1. Ensure the URL is entered correctly (no extra spaces or typos)

📌 Explanation:

A Confidential client allows the use of a Client Secret, which is required for secure authentication in mobile apps

Step 5: Save & Retrieve Credentials

1. Click Save

2. The system will display:

3. Client ID

4. Client Secret

⚠️ Important:

• The Client Secret is shown only once

• Save it immediately (recommended: password manager or secure vault)

Step 6: Configure in Ego Mobile Builder

1. Go to Ego Mobile Builder Dashboard

2. Navigate to Settings → Customer Account → No-password Login

3. Enter:

4. Client ID

5. Client Secret

6. Click Save

1. What is Headless in Shopify?
Headless is a Shopify setup that allows external applications, such as your mobile app, to securely connect with Shopify APIs and customer account services.

2. How does Headless login work with Ego Mobile Builder?
Ego Mobile Builder connects to Shopify Customer Account API through Headless. When customers log in, Shopify verifies their identity through passwordless authentication, such as OTP or a magic link, and then securely returns the login result to the mobile app.

3. Why can’t I find or enable Headless in Shopify?
Your store may not support Headless yet, or the new version of Shopify Customer Accounts may not be enabled. Make sure your store meets the prerequisites before continuing.

4. Where can I find the Client ID and Client Secret?
After you save the Customer Account API configuration in Shopify, the Client ID and Client Secret will be generated. Save the Client Secret immediately because Shopify only displays it once.

5. Where do I enter the Client ID and Client Secret in Ego Mobile Builder?
Go to Settings → Customer Account → No-password Login, enter the Client ID and Client Secret, then click Save.