---
title: "Manual Shopify Connect"
method: POST
path: "/api/shopify/manual-connect"
tags: ["Shopify OAuth"]
---

# Manual Shopify Connect

`POST /api/shopify/manual-connect`

## Request

- Base URL: `https://api.soeru.biz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.soeru.biz/api/shopify/manual-connect`
- Auth: none declared. Required headers: `authorization`

Connect a Shopify store using a manually obtained Admin API access token.

This is used for custom apps created directly in the Shopify store admin,
bypassing the OAuth flow. The token is validated via GraphQL shop query.

## Headers

- `x-shop-id` string, nullable: Optional shop ID
- `authorization` string, required: Bearer <token>

## Request body

- ManualShopifyConnectRequest: Request to connect using a manually obtained access token.
  - `store_domain` string, required
  - `access_token` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/soeru/apis/soeru-api.md) · [All operations](https://skmtc.dev/soeru/apis/soeru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soeru/apis/soeru-api/revisions/63f8d371abed?raw)