Public Reference

Add ?customer_id=YOUR_ID to personalize this page for your workspace.

OAuth Configuration

Configure these URLs in your Shopify Partner Dashboard when creating or editing your app.

📘 These instructions follow the official Shopify Dev Dashboard guide

📱 Step 1: Create a New App

  1. Go to partners.shopify.com
  2. Make sure you're on "Apps" in the left-panel navigation
  3. Click "Create app" in the top right corner
  4. Select "Start from Dev Dashboard"
  5. Enter your app name and click "Create"

🔧 Step 2: Configure App URLs

  1. From your app, go to the "Configuration" tab
  2. Set App URL to the URL shown below
  3. Add the Allowed redirect URL shown below
  4. Click "Save"

✅ Step 3: Get Your Credentials

  1. In your app configuration, find "Client credentials"
  2. Copy your Client ID and Client Secret
  3. Add these to your .env file as SHOPIFY_CLIENT_ID and SHOPIFY_CLIENT_SECRET
https://weaver.somee.ai
https://weaver.somee.ai/oauth/shopify/callback

Add this URL to your app's "Allowed redirection URL(s)" list in Shopify Partners.

https://weaver.somee.ai/oauth/shopify/redirect/{customer_id}/{shop_domain}

Replace {YOUR_SHOP} with your actual shop domain.

API Endpoints

Available REST endpoints for Shopify integration. All requests require customer-key header. For full documentation, see Swagger API Docs.

POST https://weaver.somee.ai/api/shopify/fetch-products

Fetch all products from connected Shopify stores

POST https://weaver.somee.ai/api/shopify/search-customer

Search for a customer by email or phone

POST https://weaver.somee.ai/api/shopify/search-full-customer

Get full customer details including orders

POST https://weaver.somee.ai/api/shopify/search-customer-last-order

Get customer's most recent order

POST https://weaver.somee.ai/api/shopify/find-or-create-customer

Find existing customer or create new one

POST https://weaver.somee.ai/api/shopify/create-draft-order

Create a draft order for a customer

POST https://weaver.somee.ai/api/shopify/send-draft-invoice

Send invoice for a draft order

POST https://weaver.somee.ai/api/shopify/cancel-order

Cancel an existing order

POST https://weaver.somee.ai/api/shopify/set-passphrase

Set customer passphrase for voice auth

📦 Order Endpoints

POST https://weaver.somee.ai/api/shopify/order/kit - Create kit order
POST https://weaver.somee.ai/api/shopify/order/refill-tips - Order refill tips
POST https://weaver.somee.ai/api/shopify/order/refill-gels - Order refill gels
POST https://weaver.somee.ai/api/shopify/order/add-eyethos - Add Eyethos to draft

Recurpay Subscription Endpoints

Manage Shopify subscriptions via Recurpay integration.

POST https://weaver.somee.ai/api/shopify/recurpay/search-customer-last-subscription

Get customer's last subscription

POST https://weaver.somee.ai/api/shopify/recurpay/modify-subscription

Modify an existing subscription

PUT https://weaver.somee.ai/api/shopify/recurpay/cancel-subscription

Cancel a subscription

POST https://weaver.somee.ai/api/shopify/recurpay/renew-subscription

Renew a subscription

POST https://weaver.somee.ai/api/shopify/recurpay/generate-payment-link

Generate payment link for subscription

GET https://weaver.somee.ai/api/shopify/recurpay/plans

List all subscription plans

GET https://weaver.somee.ai/api/shopify/recurpay/plans/{'{plan_id}'}

Get specific plan details

GET https://weaver.somee.ai/api/shopify/recurpay/plans/{'{plan_id}'}/products

Get products for a specific plan

Need help?

Check our full documentation or contact support for integration assistance.