Proxy GraphQL queries to Shopify Customer Account API

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

Full behavior, validation rules, and side effects

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

POST /subscriptions/cp/api/customer-account-api/graphql

Proxy GraphQL queries to Shopify Customer Account API

cURL

curl --request POST \
  --url https://www.myshop.com/apps/subscriptions/cp/api/customer-account-api/graphql \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "query { customer { id emailAddress { emailAddress } } }",
  "variables": {}
}
'

200

{
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/123",
      "emailAddress": {
        "emailAddress": "[e-mail]"
      }
    }
  }
}

Body

application/json

GraphQL query and optional variables

query · string

variables · object

Show child attributes

Response

200

application/json

GraphQL query executed successfully