> For the complete documentation index, see [llms.txt](https://opusecom.gitbook.io/opus-mobile-builder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://opusecom.gitbook.io/opus-mobile-builder/settings/headlessconfiguration.md).

# Headless Configuration Guide

### 1. Overview

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.

***

### 2. Prerequisites

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

***

### 3. Setup Instructions

#### Step 1: Enable Headless in Shopify

1. Go to Shopify App Store
2. Install Headless 

![](/files/9qZ1NpiitB5jl8xrEcWQ)

👉 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

![](/files/X7ch2dE4R2srET8YlX7Y)

✅ 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

![](/files/HiZil8tMHWLadr8YAZhw)

***

#### Step 4: Configure Client Type

1. In the Customer Account API settings:
2. Select Client type = Confidential

![](/files/AMhCKgrcWy6kG6mxkOxP)

2. In Application setup, locate Callback URI(s) (required)
3. Add the following URL:

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

![](/files/jlYkwP66LBb0qTsrAvxn)

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

<br>

📌 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

![](/files/9iBSTnQKneuuauL1VWmm)

⚠️ 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&#x20;

![](/files/ZwAdcPRNSmI3YUXKaRV5)

\ <br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://opusecom.gitbook.io/opus-mobile-builder/settings/headlessconfiguration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.