Skip to content
Customer Portal APIs
/
/
Get available loyalty poi...

Customer Portal APIs (0.0.1)

Comprehensive API documentation for the customer-facing subscription portal. These APIs enable customers to manage their subscriptions, update billing information, modify delivery schedules, and access their account details through your storefront.

Important: These APIs must be called from your shop's domain (e.g., https://www.myshop.com/apps/subscriptions/cp/api/**) and require customer authentication. Unauthenticated requests will return a 401 Unauthorized error.

Download OpenAPI description
customer-portal-swagger.json
customer-portal-swagger.yaml
Languages
Servers
https://www.myshop.com/apps

Customer Portal

Core customer portal APIs for managing customer account settings, authentication, and portal configurations.

Operations

Proxy GraphQL queries to Shopify Customer Account API

Request

Executes GraphQL queries against Shopify's Customer Account API on behalf of the authenticated customer. This endpoint handles token management, refresh, and authentication automatically.

What you can query:

  • Customer profile information
  • Order history and details
  • Saved addresses
  • Payment methods
  • Subscriptions (via Customer Account API schema)

Token Management:

  • Automatically uses stored access token
  • Refreshes expired tokens automatically
  • Returns 401 if customer needs to re-authenticate

Example Queries:

query {
  customer {
    id
    emailAddress { emailAddress }
    defaultAddress { address1 city }
  }
}

Authentication: Customer must be logged in and have completed OAuth flow

Bodyapplication/jsonrequired

GraphQL query and optional variables

querystring
variablesobject
curl -i -X POST \
  https://www.myshop.com/apps/subscriptions/cp/api/customer-account-api/graphql \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "query { customer { id emailAddress { emailAddress } } }",
    "variables": {}
  }'

Responses

GraphQL query executed successfully

Bodyapplication/json
Response
application/json
{
  "data": {
    "customer": { … }
  }
}

Get available loyalty point redemption options

Request

Returns all available rewards that the customer can redeem their loyalty points for. This shows customers what they can spend their points on.

Common Redemption Options:

  • Discount codes (e.g., $5 off for 500 points)
  • Percentage discounts (e.g., 10% off for 1000 points)
  • Free shipping rewards
  • Free products or samples
  • Exclusive access to sales

Response includes:

  • Redemption option ID
  • Name and description
  • Points cost
  • Reward value (dollar amount or percentage)
  • Availability (minimum purchase, restrictions)
  • Whether customer has enough points

Filtering:

  • Only shows active redemption options
  • Filters based on customer's tier/VIP level
  • Shows whether customer has sufficient points

Use Cases:

  • Display 'Redeem Points' section in customer portal
  • Show available rewards in checkout
  • Encourage customers to save points for bigger rewards

Authentication: Customer must be logged in via Shopify customer session

curl -i -X GET \
  https://www.myshop.com/apps/subscriptions/cp/api/loyalty-integration/redeem-options

Responses

Redemption options retrieved successfully

Bodyapplication/json
Response
application/json
[
  {
    "id": 1,
    "name": "$5 Off Coupon",
    "description": "Get $5 off your next order",
    "pointsCost": 500,
    "rewardValue": 5,
    "rewardType": "FIXED_AMOUNT",
    "canRedeem": true
  },
  {
    "id": 2,
    "name": "15% Off Entire Order",
    "description": "Get 15% off your entire order",
    "pointsCost": 1500,
    "rewardValue": 15,
    "rewardType": "PERCENTAGE",
    "canRedeem": true
  }
]

Get customer loyalty points and rewards data

Request

Retrieves the loyalty/rewards program data for the currently logged-in customer. This includes points balance, tier status, and available rewards.

Supported Loyalty Programs:

  • Appstle Loyalty & Rewards
  • Yotpo Loyalty & Referrals
  • Smile.io (via Appstle integration)

What you get:

  • Current points balance
  • Points pending (from recent orders)
  • VIP tier/level
  • Points history
  • Available reward redemptions

Use Cases:

  • Display points balance in customer portal
  • Show available rewards customer can redeem
  • Display VIP tier badge
  • Show points expiration dates

Authentication: Customer must be logged in via Shopify customer session

Note: Requires loyalty app integration to be configured in merchant settings

curl -i -X GET \
  https://www.myshop.com/apps/subscriptions/cp/api/loyalty-integration/customer

Responses

Loyalty data retrieved successfully

Bodyapplication/json
Response
application/json
{
  "pointsBalance": 1250,
  "pointsPending": 150,
  "tierName": "Gold",
  "pointsToNextTier": 250,
  "customerEmail": "customer@example.com"
}

Subscription Management

APIs for customers to view and manage their subscription contracts including status updates, frequency changes, and cancellations.

Operations

Billing & Payments

APIs for managing payment methods, billing information, and processing subscription payments.

Operations

Product Catalog

APIs for retrieving product information, selling plans, variant data, and subscription-enabled products available to customers.

Operations

Delivery & Shipping

APIs for managing delivery schedules, shipping addresses, delivery methods, and tracking order status.

Customer Retention

APIs for handling subscription cancellations, retention activities, and customer feedback management.

Loyalty Integration

APIs for integrating loyalty programs with subscriptions including points redemption and earning options.

Customization

APIs for accessing portal customization settings, translations, and theme configurations.