Welcome to the Ako apps Integration Documentation, where we guide you through seamlessly integrating Ako apps with the Shopify Admin API.
\nBoth Ako Marketing and Ako CVS seamlessly integrates with the Shopify Admin API, eliminating the need for additional APIs. Leverage the power of Shopify's existing infrastructure to enhance your integration with precision and ease. If you'd like to directly access the Ako Marketing API, you can refer to this paragraph.
\nThe Shopify Admin API supports both GraphQL and REST. The examples provided in this documentation assume a foundational understanding of how to use the Shopify Admin API, i.e., you know how to configure the three variables in the following table.
\nRefer to the Shopify documentation for comprehensive guidance on authentication, endpoints, rate limits, and general API usage.
\nThe Ako Marketing API lets you integrate customer data and loyalty actions (e.g., points changes) into your stack. This guide covers authentication and common customer operations.
\nBefore any API operations, you will need to get an access token via authentication process.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Ako Marketing API","slug":"ako-marketing-api"}],"owner":"31929572","collectionId":"25e55c0c-1754-40d1-a5c9-6548e481c294","publishedId":"2s9Ykq81Bw","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"ED8936"},"publishDate":"2025-10-31T10:57:29.000Z"},"item":[{"name":"Get points, tier, birthday, gender and referralCode of a customer","item":[{"name":"GraphQL","id":"379a6dc7-2ed4-41e4-859b-59863da2e8e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"body":{"mode":"graphql","graphql":{"query":"query {\n customer(id: \"gid://shopify/Customer/6223356756011\") {\n points: metafield(\n namespace: \"akohub\"\n key: \"points\"\n ) {\n value\n }\n tier: metafield(\n namespace: \"akohub\"\n key: \"tier\"\n ) {\n value\n }\n birthday: metafield(\n namespace: \"akohub\"\n key: \"birthday\"\n ) {\n value\n }\n gender: metafield(\n namespace: \"akohub\"\n key: \"gender\"\n ) {\n value\n }\n referralCode: metafield(\n namespace: \"akohub\"\n key: \"referralCode\"\n ) {\n value\n }\n }\n}","variables":""}},"url":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/graphql.json","urlObject":{"protocol":"https","path":["admin","api","{{shopify-api-version}}","graphql.json"],"host":["{{shopify-store}}"],"query":[],"variable":[]}},"response":[{"id":"5a3bf225-0dd1-4912-be9a-badfedbd284b","name":"Success","originalRequest":{"method":"POST","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"body":{"mode":"graphql","graphql":{"query":"query {\n customer(id: \"gid://shopify/Customer/6223356756011\") {\n points: metafield(\n namespace: \"akohub\"\n key: \"points\"\n ) {\n value\n }\n tier: metafield(\n namespace: \"akohub\"\n key: \"tier\"\n ) {\n value\n }\n birthday: metafield(\n namespace: \"akohub\"\n key: \"birthday\"\n ) {\n value\n }\n gender: metafield(\n namespace: \"akohub\"\n key: \"gender\"\n ) {\n value\n }\n referralCode: metafield(\n namespace: \"akohub\"\n key: \"referralCode\"\n ) {\n value\n }\n }\n}","variables":""}},"url":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/graphql.json"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 22 Dec 2023 07:59:55 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Sorting-Hat-PodId","value":"112"},{"key":"X-Sorting-Hat-ShopId","value":"7648215153"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Referrer-Policy","value":"origin-when-cross-origin"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-ShopId","value":"7648215153"},{"key":"X-ShardId","value":"112"},{"key":"X-Stats-UserId","value":""},{"key":"X-Stats-ApiClientId","value":"6389563"},{"key":"X-Stats-ApiPermissionId","value":"356878549105"},{"key":"X-Shopify-API-Version","value":"2023-10"},{"key":"Content-Language","value":"en"},{"key":"Strict-Transport-Security","value":"max-age=7889238"},{"key":"Server-Timing","value":"processing;dur=59, graphql;desc=\"admin/query/other\""},{"key":"Server-Timing","value":"cfRequestDuration;dur=558.999777"},{"key":"X-Shopify-Stage","value":"production"},{"key":"Content-Security-Policy","value":"default-src 'self' data: blob: 'unsafe-inline' 'unsafe-eval' https://* shopify-pos://*; block-all-mixed-content; child-src 'self' https://* shopify-pos://*; connect-src 'self' wss://* https://*; frame-ancestors 'none'; img-src 'self' data: blob: https:; script-src https://cdn.shopify.com https://cdn.shopifycdn.net https://checkout.shopifycs.com https://api.stripe.com https://mpsnare.iesnare.com https://appcenter.intuit.com https://www.paypal.com https://js.braintreegateway.com https://c.paypal.com https://maps.googleapis.com https://www.google-analytics.com https://v.shopify.com 'self' 'unsafe-inline' 'unsafe-eval'; upgrade-insecure-requests; report-uri /csp-report?source%5Baction%5D=query&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Fgraphql&source%5Bsection%5D=admin_api&source%5Buuid%5D=f586e6c3-d1d1-4de8-ac3f-309fd9e81696"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block; report=/xss-report?source%5Baction%5D=query&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Fgraphql&source%5Bsection%5D=admin_api&source%5Buuid%5D=f586e6c3-d1d1-4de8-ac3f-309fd9e81696"},{"key":"X-Request-ID","value":"f586e6c3-d1d1-4de8-ac3f-309fd9e81696"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=IEoH0618XdQLk5fT3boaJKnfjtot5HyQXNVwBaHDacTLnHYdbBohI%2F6uZSOCcsugrVYoFe2tsbGXaujkQVIiWEM89l6zJE8HOFeKJaW3CgjtJhBIbjuZk3p3BzDg9ZfAPWVGgTOadv8L0wj7cwa9KFk%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8396d3ff690eafb1-NRT"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"customer\": {\n \"points\": {\n \"value\": \"100\"\n },\n \"tier\": {\n \"value\": \"Bronze\"\n },\n \"birthday\": {\n \"value\": \"1992-09-11\"\n },\n \"gender\": {\n \"value\": \"Man\"\n },\n \"referralCode\": {\n \"value\": \"qduLGThznByA\"\n }\n }\n },\n \"extensions\": {\n \"cost\": {\n \"requestedQueryCost\": 6,\n \"actualQueryCost\": 6,\n \"throttleStatus\": {\n \"maximumAvailable\": 2000.0,\n \"currentlyAvailable\": 1994,\n \"restoreRate\": 100.0\n }\n }\n }\n}"}],"_postman_id":"379a6dc7-2ed4-41e4-859b-59863da2e8e2"},{"name":"REST","id":"d2448684-84b5-400a-9f29-056ef02149e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"url":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/customers/6223356756011/metafields.json?namespace=akohub","urlObject":{"protocol":"https","path":["admin","api","{{shopify-api-version}}","customers","6223356756011","metafields.json"],"host":["{{shopify-store}}"],"query":[{"key":"namespace","value":"akohub"}],"variable":[]}},"response":[{"id":"cb0179f4-debf-4d6c-8d6c-886ad338f0f2","name":"Success","originalRequest":{"method":"GET","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"url":{"raw":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/customers/6223356756011/metafields.json?namespace=akohub","protocol":"https","host":["{{shopify-store}}"],"path":["admin","api","{{shopify-api-version}}","customers","6223356756011","metafields.json"],"query":[{"key":"namespace","value":"akohub"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 24 Dec 2023 03:42:34 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Sorting-Hat-PodId","value":"176"},{"key":"X-Sorting-Hat-ShopId","value":"59007467697"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Referrer-Policy","value":"origin-when-cross-origin"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-ShopId","value":"59007467697"},{"key":"X-ShardId","value":"176"},{"key":"X-Stats-UserId","value":""},{"key":"X-Stats-ApiClientId","value":"6536061"},{"key":"X-Stats-ApiPermissionId","value":"371370623153"},{"key":"X-Shopify-API-Terms","value":"By accessing or using the Shopify API you agree to the Shopify API License and Terms of Use at https://www.shopify.com/legal/api-terms"},{"key":"X-Shopify-API-Version","value":"2023-10"},{"key":"HTTP_X_SHOPIFY_SHOP_API_CALL_LIMIT","value":"1/40"},{"key":"X-Shopify-Shop-Api-Call-Limit","value":"1/40"},{"key":"Strict-Transport-Security","value":"max-age=7889238"},{"key":"Server-Timing","value":"processing;dur=61"},{"key":"Server-Timing","value":"cfRequestDuration;dur=279.999971"},{"key":"X-Shopify-Stage","value":"production"},{"key":"Content-Security-Policy","value":"default-src 'self' data: blob: 'unsafe-inline' 'unsafe-eval' https://* shopify-pos://*; block-all-mixed-content; child-src 'self' https://* shopify-pos://*; connect-src 'self' wss://* https://*; frame-ancestors 'none'; img-src 'self' data: blob: https:; script-src https://cdn.shopify.com https://cdn.shopifycdn.net https://checkout.shopifycs.com https://api.stripe.com https://mpsnare.iesnare.com https://appcenter.intuit.com https://www.paypal.com https://js.braintreegateway.com https://c.paypal.com https://maps.googleapis.com https://www.google-analytics.com https://v.shopify.com 'self' 'unsafe-inline' 'unsafe-eval'; upgrade-insecure-requests; report-uri /csp-report?source%5Baction%5D=index&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Fmetafields&source%5Bsection%5D=admin_api&source%5Buuid%5D=07cba641-599d-4efa-904c-051f29b6e0f0"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block; report=/xss-report?source%5Baction%5D=index&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Fmetafields&source%5Bsection%5D=admin_api&source%5Buuid%5D=07cba641-599d-4efa-904c-051f29b6e0f0"},{"key":"X-Request-ID","value":"07cba641-599d-4efa-904c-051f29b6e0f0"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=HvrwQbRtAGPSQPVqLurE8p3RavJN%2FNOIZwDaBwIFcriyy0mhHBmzEfjrBTpU7c%2BwqlMfCmHsqzunKggyNjhaQLHW7Cs0JPVn6QbWLYreZBI605Xog%2BSc%2FOIzew%2F92Cl238ilVlSUWEo%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"83a5d5c52bc5a3a9-TPE"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"metafields\": [\n {\n \"id\": 20965480202283,\n \"namespace\": \"akohub\",\n \"key\": \"points\",\n \"value\": \"100\",\n \"description\": null,\n \"owner_id\": 6223356756011,\n \"created_at\": \"2023-04-17T23:32:36-04:00\",\n \"updated_at\": \"2024-02-20T01:51:44-05:00\",\n \"owner_resource\": \"customer\",\n \"type\": \"single_line_text_field\",\n \"admin_graphql_api_id\": \"gid://shopify/Metafield/20965480202283\"\n },\n {\n \"id\": 20966842499115,\n \"namespace\": \"akohub\",\n \"key\": \"tier\",\n \"value\": \"Bronze\",\n \"description\": null,\n \"owner_id\": 6223356756011,\n \"created_at\": \"2023-04-18T06:15:44-04:00\",\n \"updated_at\": \"2024-01-28T23:59:21-05:00\",\n \"owner_resource\": \"customer\",\n \"type\": \"single_line_text_field\",\n \"admin_graphql_api_id\": \"gid://shopify/Metafield/20966842499115\"\n },\n {\n \"id\": 21201380900907,\n \"namespace\": \"akohub\",\n \"key\": \"birthday\",\n \"value\": \"1992-09-11\",\n \"description\": null,\n \"owner_id\": 6223356756011,\n \"created_at\": \"2023-06-20T05:04:13-04:00\",\n \"updated_at\": \"2023-10-30T22:27:36-04:00\",\n \"owner_resource\": \"customer\",\n \"type\": \"single_line_text_field\",\n \"admin_graphql_api_id\": \"gid://shopify/Metafield/21201380900907\"\n },\n {\n \"id\": 21201380933675,\n \"namespace\": \"akohub\",\n \"key\": \"gender\",\n \"value\": \"Man\",\n \"description\": null,\n \"owner_id\": 6223356756011,\n \"created_at\": \"2023-06-20T05:04:13-04:00\",\n \"updated_at\": \"2023-06-20T05:04:13-04:00\",\n \"owner_resource\": \"customer\",\n \"type\": \"single_line_text_field\",\n \"admin_graphql_api_id\": \"gid://shopify/Metafield/21201380933675\"\n },\n {\n \"id\": 23305719644203,\n \"namespace\": \"akohub\",\n \"key\": \"referralCode\",\n \"value\": \"qduLGThznByA\",\n \"description\": null,\n \"owner_id\": 6223356756011,\n \"created_at\": \"2024-01-26T03:27:20-05:00\",\n \"updated_at\": \"2024-01-26T03:27:20-05:00\",\n \"owner_resource\": \"customer\",\n \"type\": \"string\",\n \"admin_graphql_api_id\": \"gid://shopify/Metafield/23305719644203\"\n }\n ]\n}"}],"_postman_id":"d2448684-84b5-400a-9f29-056ef02149e0"}],"id":"7f393e5d-ccef-457b-9359-d94433a119d0","description":"The Ako Marketing app must be installed on your Shopify store.
\nThe points balance, VIP tier, birthday, gender and referralCode of a customer are recorded in metafields. Some parsing is necessary because these values are stored as single-line text in Shopify.
\n","_postman_id":"7f393e5d-ccef-457b-9359-d94433a119d0"},{"name":"Get points and checkout redemption settings","item":[{"name":"GraphQL","id":"9f6e860e-ca5a-47a8-894c-50d269bb4878","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"body":{"mode":"graphql","graphql":{"query":"query {\n shop {\n id\n myshopifyDomain\n name\n metafield(namespace: \"akohub\", key: \"checkout-redemption\") {\n key\n value\n }\n }\n}","variables":""}},"url":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/graphql.json","urlObject":{"protocol":"https","path":["admin","api","{{shopify-api-version}}","graphql.json"],"host":["{{shopify-store}}"],"query":[],"variable":[]}},"response":[{"id":"cfec5946-23ee-42b2-a31d-b7b523e5c8ea","name":"Success","originalRequest":{"method":"POST","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"body":{"mode":"graphql","graphql":{"query":"query {\n shop {\n id\n myshopifyDomain\n name\n metafield(namespace: \"akohub\", key: \"checkout-redemption\") {\n key\n value\n }\n }\n}","variables":""}},"url":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/graphql.json"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 03 Nov 2025 06:06:03 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-sorting-hat-podid","value":"157"},{"key":"x-sorting-hat-shopid","value":"56251777182"},{"key":"vary","value":"Accept-Encoding"},{"key":"referrer-policy","value":"origin-when-cross-origin"},{"key":"x-frame-options","value":"DENY"},{"key":"x-shopid","value":"56251777182"},{"key":"x-shardid","value":"157"},{"key":"x-stats-userid","value":""},{"key":"x-stats-apiclientid","value":"1324983"},{"key":"x-stats-apipermissionid","value":"407167893662"},{"key":"x-shopify-api-version","value":"2025-10"},{"key":"content-language","value":"en"},{"key":"strict-transport-security","value":"max-age=7889238"},{"key":"x-request-id","value":"88151551-80b7-45a2-a332-85e3b71cc733-1762149963"},{"key":"server-timing","value":"processing;dur=50, verdict_flag_enabled;desc=\"count=14\";dur=3.67, graphql;desc=\"admin/query/other\", _y;desc=\"c53d020d-4a0d-4c74-82af-b03e353edbf4\", _s;desc=\"5c852602-be85-411e-9318-79639ae316c8\""},{"key":"content-security-policy","value":"default-src 'self' data: blob: 'unsafe-inline' 'unsafe-eval' https://* shopify-pos://*; block-all-mixed-content; child-src 'self' https://* shopify-pos://*; connect-src 'self' wss://* https://*; frame-ancestors 'none'; img-src 'self' data: blob: https:; script-src https://cdn.shopify.com https://cdn.shopifycdn.net https://checkout.pci.shopifyinc.com https://checkout.pci.shopifyinc.com/build/75a428d/card_fields.js https://api.stripe.com https://mpsnare.iesnare.com https://appcenter.intuit.com https://www.paypal.com https://js.braintreegateway.com https://c.paypal.com https://maps.googleapis.com https://www.google-analytics.com https://v.shopify.com 'self' 'unsafe-inline' 'unsafe-eval'; upgrade-insecure-requests; report-uri /csp-report?source%5Baction%5D=query&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Fgraphql&source%5Bsection%5D=admin_api&source%5Buuid%5D=88151551-80b7-45a2-a332-85e3b71cc733-1762149963; report-to shopify-csp"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-download-options","value":"noopen"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"reporting-endpoints","value":"shopify-csp=\"/csp-report?source%5Baction%5D=query&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Fgraphql&source%5Bsection%5D=admin_api&source%5Buuid%5D=88151551-80b7-45a2-a332-85e3b71cc733-1762149963\""},{"key":"x-dc","value":"gcp-us-east1,gcp-us-east1,gcp-us-east1"},{"key":"content-encoding","value":"gzip"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=86400"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=VvkZ0IPAGHPFD%2FdHiLj5pC6D2MleplFQ0Ea9TRErCnQwv4KCdwgzFWx91N0XyMQj%2FgUxw10BGmS9XVNgPg4EtyMlOKitR78jsMiAMtRNfEoCdtqu3yddQDFHmY2kOdmOOnljac4en71F2mTi%2BKqF9mM%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server-Timing","value":"cfRequestDuration;dur=98.999977"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9989aef559f5aa23-IAD"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"shop\": {\n \"id\": \"gid://shopify/Shop/56251777182\",\n \"myshopifyDomain\": \"salt-and-sugar-tw.myshopify.com\",\n \"name\": \"Salt & Sugar \",\n \"metafield\": {\n \"key\": \"checkout-redemption\",\n \"value\": \"{\\\"shop\\\":{\\\"moneyFormat\\\":\\\"${{amount}}\\\",\\\"isMultiPassEnabled\\\":false,\\\"enabledPlatforms\\\":[\\\"line\\\",\\\"google\\\",\\\"instagram\\\",\\\"facebook\\\"],\\\"features\\\":[\\\"Discount\\\",\\\"DisableRedemptionForProducts\\\",\\\"JudgeMe\\\",\\\"TieredDiscount\\\",\\\"AnalyzeCartSubtotalSelector\\\",\\\"KlaviyoEvent\\\",\\\"AIMarketing\\\",\\\"ProductRedemptionRestrictions\\\",\\\"SHOP_DASHBOARD\\\",\\\"LoyaltyVIP\\\",\\\"ManualRedemption\\\",\\\"Retargeting\\\",\\\"Google\\\",\\\"Multipass\\\",\\\"StoreCredit\\\",\\\"SocialLogin\\\",\\\"CheckoutReward\\\",\\\"CheckoutRedemption\\\",\\\"EmailCampaign\\\",\\\"AnalyzeDrawerSubtotalSelector\\\",\\\"POS\\\",\\\"Referral\\\",\\\"Instagram\\\",\\\"Loyalty\\\"],\\\"cdnHostName\\\":\\\"https://tags.akohub.com\\\",\\\"hostName\\\":\\\"https://app.akohub.com\\\",\\\"appProxyPath\\\":\\\"/apps/akohub/\\\",\\\"currency\\\":\\\"USD\\\",\\\"timezone\\\":\\\"America/New_York\\\",\\\"accountVersion\\\":\\\"new_customer_accounts\\\"},\\\"pointsSetting\\\":{\\\"pointName\\\":{\\\"singular\\\":\\\"Point\\\",\\\"plural\\\":\\\"Points\\\"},\\\"discountLimit\\\":{\\\"percentage\\\":\\\"30\\\",\\\"type\\\":\\\"percentage\\\"},\\\"title\\\":\\\"Salt & Sugars\\\",\\\"pointBackRate\\\":null,\\\"pointRedeemRate\\\":{\\\"points\\\":\\\"100\\\",\\\"cashBack\\\":\\\"1\\\"},\\\"enabled\\\":true,\\\"redemptionTitle\\\":\\\"redeem points:\\\",\\\"redeemThreshold\\\":100,\\\"decimalPlaces\\\":0},\\\"walletSetting\\\":{\\\"enabled\\\":false,\\\"redemptionTitle\\\":\\\"redeem points:\\\",\\\"redeemThreshold\\\":0,\\\"decimalPlaces\\\":0},\\\"vipSetting\\\":{\\\"enabled\\\":true,\\\"vips\\\":[{\\\"perks\\\":[],\\\"rewards\\\":[{\\\"pointsExpiry\\\":3,\\\"rewardValue\\\":100,\\\"rewardType\\\":\\\"points\\\",\\\"title\\\":\\\"Points reward\\\",\\\"enabled\\\":true,\\\"id\\\":\\\"MI0VwBMUojqTJwNrOPQsR\\\",\\\"icon\\\":{\\\"alt\\\":\\\"point icon\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/point.svg\\\"}},{\\\"title\\\":\\\"Store credit\\\",\\\"enabled\\\":true,\\\"id\\\":\\\"OmJJd2m6NYnoTkQEfTzmI\\\",\\\"rewardValue\\\":10,\\\"icon\\\":{\\\"alt\\\":\\\"Store credit\\\",\\\"url\\\":\\\"https://akohub-images.s3.us-east-1.amazonaws.com/store-credit-icon.svg\\\"},\\\"rewardType\\\":\\\"storeCredit\\\"}],\\\"checkoutReward\\\":null,\\\"entries\\\":{\\\"amount\\\":0},\\\"icon\\\":{\\\"alt\\\":\\\"blue medal\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/blue-medal.svg\\\"},\\\"id\\\":\\\"8dc636351fbb4ed69255fa399591a151\\\",\\\"isStarter\\\":true,\\\"tag\\\":\\\"ako-starter\\\",\\\"tierLevel\\\":10028,\\\"name\\\":\\\"Starter\\\"},{\\\"perks\\\":[\\\"special product!\\\"],\\\"keepEntries\\\":{\\\"amount\\\":3000},\\\"rewards\\\":[{\\\"pointsExpiry\\\":1,\\\"rewardValue\\\":{\\\"title\\\":\\\"2Amount off order\\\",\\\"minimumRequirement\\\":{},\\\"usageLimit\\\":1,\\\"customerGets\\\":{\\\"percentage\\\":\\\"0.30\\\"},\\\"combinesWith\\\":{\\\"orderDiscounts\\\":true,\\\"shippingDiscounts\\\":true,\\\"productDiscounts\\\":true},\\\"discountType\\\":\\\"amountOffOrder\\\"},\\\"rewardType\\\":\\\"discountCode\\\",\\\"title\\\":\\\"2Amount off order\\\",\\\"enabled\\\":true,\\\"id\\\":\\\"qscMWpBC3QOH1JBjcWadL\\\",\\\"icon\\\":{\\\"alt\\\":\\\"amount off order discount\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/discount.svg\\\"}}],\\\"checkoutReward\\\":{\\\"value\\\":0.15,\\\"title\\\":\\\"Gold Member 15% off\\\",\\\"type\\\":\\\"amountOffOrder\\\",\\\"discountType\\\":\\\"percentage\\\"},\\\"icon\\\":{\\\"alt\\\":\\\"gold medal\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/gold-medal.svg\\\"},\\\"id\\\":\\\"10c3af13528c4e2b8a0dabff1fc425fd\\\",\\\"tag\\\":\\\"ako-gold\\\",\\\"entries\\\":{\\\"amount\\\":3000},\\\"tierLevel\\\":20080,\\\"name\\\":\\\"Gold\\\"},{\\\"perks\\\":[],\\\"rewards\\\":[{\\\"title\\\":\\\"Store credit\\\",\\\"enabled\\\":true,\\\"id\\\":\\\"0h8rnLRcvX9ipgqX6wQ65\\\",\\\"rewardValue\\\":30,\\\"icon\\\":{\\\"alt\\\":\\\"Store credit\\\",\\\"url\\\":\\\"https://akohub-images.s3.us-east-1.amazonaws.com/store-credit-icon.svg\\\"},\\\"rewardType\\\":\\\"storeCredit\\\"}],\\\"checkoutReward\\\":{\\\"value\\\":0.25,\\\"title\\\":\\\"Platinum Member 25% off\\\",\\\"type\\\":\\\"amountOffOrder\\\",\\\"discountType\\\":\\\"percentage\\\"},\\\"icon\\\":{\\\"alt\\\":\\\"platium medal\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/platinum-medal.svg\\\"},\\\"id\\\":\\\"6a8f0345164347d69fcb663a16f37758\\\",\\\"tag\\\":\\\"ako-platinum\\\",\\\"entries\\\":{\\\"amount\\\":6000},\\\"tierLevel\\\":30044,\\\"name\\\":\\\"Platinum\\\"},{\\\"perks\\\":[\\\"Birthday Gift, Exclusive Offers and Coupons, Gift Set Worth 25K, Time Bound Sales, Early Access to Sales, \\\"],\\\"keepEntries\\\":{\\\"amount\\\":50000},\\\"rewards\\\":[{\\\"pointsExpiry\\\":1,\\\"rewardValue\\\":{\\\"title\\\":\\\"Free shipping 1\\\",\\\"minimumRequirement\\\":{},\\\"usageLimit\\\":1,\\\"combinesWith\\\":{\\\"orderDiscounts\\\":true,\\\"productDiscounts\\\":true},\\\"discountType\\\":\\\"freeShipping\\\"},\\\"rewardType\\\":\\\"discountCode\\\",\\\"title\\\":\\\"Free shipping 1\\\",\\\"enabled\\\":true,\\\"id\\\":\\\"TxhZXQXO2R9n3ui2gllra\\\",\\\"icon\\\":{\\\"alt\\\":\\\"free shipping discount\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/free-shipping-discount.svg\\\"}},{\\\"pointsExpiry\\\":1,\\\"rewardValue\\\":{\\\"title\\\":\\\"Free shipping 2\\\",\\\"minimumRequirement\\\":{},\\\"usageLimit\\\":1,\\\"combinesWith\\\":{\\\"orderDiscounts\\\":true,\\\"productDiscounts\\\":true},\\\"discountType\\\":\\\"freeShipping\\\"},\\\"rewardType\\\":\\\"discountCode\\\",\\\"title\\\":\\\"Free shipping 2\\\",\\\"enabled\\\":true,\\\"id\\\":\\\"A60Z7fCEbAUVDkSAop8Is\\\",\\\"icon\\\":{\\\"alt\\\":\\\"free shipping discount\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/free-shipping-discount.svg\\\"}},{\\\"pointsExpiry\\\":1,\\\"rewardValue\\\":{\\\"title\\\":\\\"Free shipping 3\\\",\\\"minimumRequirement\\\":{},\\\"usageLimit\\\":1,\\\"combinesWith\\\":{\\\"orderDiscounts\\\":true,\\\"productDiscounts\\\":true},\\\"discountType\\\":\\\"freeShipping\\\"},\\\"rewardType\\\":\\\"discountCode\\\",\\\"title\\\":\\\"Free shipping 3\\\",\\\"enabled\\\":true,\\\"id\\\":\\\"AsFjw4gYKgbBv1yEo7Cvo\\\",\\\"icon\\\":{\\\"alt\\\":\\\"free shipping discount\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/free-shipping-discount.svg\\\"}},{\\\"pointsExpiry\\\":1,\\\"rewardValue\\\":{\\\"title\\\":\\\"Free shipping 4\\\",\\\"minimumRequirement\\\":{},\\\"usageLimit\\\":1,\\\"combinesWith\\\":{\\\"orderDiscounts\\\":true,\\\"productDiscounts\\\":true},\\\"discountType\\\":\\\"freeShipping\\\"},\\\"rewardType\\\":\\\"discountCode\\\",\\\"title\\\":\\\"Free shipping 4\\\",\\\"enabled\\\":true,\\\"id\\\":\\\"giPq1SInOQlQzvgipdXTK\\\",\\\"icon\\\":{\\\"alt\\\":\\\"free shipping discount\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/free-shipping-discount.svg\\\"}},{\\\"pointsExpiry\\\":1,\\\"rewardValue\\\":{\\\"title\\\":\\\"Free shipping 5\\\",\\\"minimumRequirement\\\":{},\\\"usageLimit\\\":1,\\\"combinesWith\\\":{\\\"orderDiscounts\\\":true,\\\"productDiscounts\\\":true},\\\"discountType\\\":\\\"freeShipping\\\"},\\\"rewardType\\\":\\\"discountCode\\\",\\\"title\\\":\\\"Free shipping 5\\\",\\\"enabled\\\":true,\\\"id\\\":\\\"i_6RFF2_JZpqkQaarOYtV\\\",\\\"icon\\\":{\\\"alt\\\":\\\"free shipping discount\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/free-shipping-discount.svg\\\"}}],\\\"checkoutReward\\\":null,\\\"icon\\\":{\\\"alt\\\":\\\"silver medal\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/silver-medal.svg\\\"},\\\"id\\\":\\\"f95668b448e9446291ec37f8243bcc3d\\\",\\\"tag\\\":\\\"ako-silver\\\",\\\"entries\\\":{\\\"amount\\\":50000},\\\"tierLevel\\\":40062,\\\"name\\\":\\\"Platinum Lux\\\"},{\\\"perks\\\":[],\\\"rewards\\\":[],\\\"checkoutReward\\\":null,\\\"id\\\":\\\"GjoduTHmtzNnnvoUxDSPG\\\",\\\"icon\\\":{\\\"alt\\\":\\\"blue medal\\\",\\\"url\\\":\\\"https://akohub-images.s3.amazonaws.com/blue-medal.svg\\\"},\\\"tag\\\":\\\"ako-black\\\",\\\"tierLevel\\\":50003,\\\"name\\\":\\\"Black\\\"}],\\\"expire\\\":12,\\\"entries\\\":[\\\"amount\\\"],\\\"isRenewalEnabled\\\":true},\\\"referralSetting\\\":{\\\"referredCustomerCreateBefore\\\":30,\\\"shopName\\\":\\\"Salt & Sugar \\\",\\\"referralMessage\\\":\\\"Join me at {{shopName}}! Sign up and use my referral code {{referralCode}} to get {{rewardCollection}}! {{redirectLink}}\\\",\\\"socialShare\\\":{\\\"line\\\":true,\\\"twitter\\\":true,\\\"faceBook\\\":true,\\\"email\\\":true},\\\"enabled\\\":false,\\\"revokedRewardMethod\\\":\\\"full\\\",\\\"referralLink\\\":\\\"https://salt-and-sugar-tw.myshopify.com\\\",\\\"issueDelay\\\":{\\\"afterDays\\\":0,\\\"type\\\":\\\"afterPaid\\\"}},\\\"storeCreditSetting\\\":{\\\"enabled\\\":true,\\\"name\\\":{\\\"singular\\\":\\\"Store credit\\\",\\\"plural\\\":\\\"Store credits\\\"},\\\"decimalPlaces\\\":2},\\\"ui\\\":{\\\"isRewardEnabled\\\":true,\\\"showPointDiscount\\\":false,\\\"widgetAppearance\\\":{\\\"triggerButton\\\":{\\\"type\\\":\\\"iconWithText\\\",\\\"position\\\":\\\"bottomRight\\\",\\\"text\\\":\\\"Loyalty Program\\\",\\\"textColor\\\":\\\"#fdf1b4ff\\\",\\\"icon\\\":\\\"https://akohub-images.s3.amazonaws.com/icon-gift.svg\\\",\\\"textRotation\\\":\\\"default\\\",\\\"offset\\\":{\\\"x\\\":0,\\\"y\\\":0,\\\"bottom\\\":0,\\\"top\\\":0},\\\"backgroundColor\\\":\\\"#714d22ff\\\"},\\\"color\\\":{\\\"primaryColor\\\":\\\"#714d22ff\\\",\\\"headingTextColor\\\":\\\"#161514ff\\\",\\\"bodyTextColor\\\":\\\"#635442ff\\\"}},\\\"gender\\\":{\\\"transgender\\\":true,\\\"nonBinary\\\":true,\\\"man\\\":true,\\\"woman\\\":true,\\\"other\\\":true},\\\"popupSettings\\\":{\\\"openOnCustomerVisit\\\":true,\\\"openOnCustomerLogin\\\":true,\\\"openOnThankyouPage\\\":false},\\\"selectors\\\":{\\\"subtotal\\\":\\\".totals__total-value\\\",\\\"pointDiscount\\\":null},\\\"customStyleSheet\\\":\\\"\\\",\\\"showSocialLoginAtAccountPage\\\":false,\\\"applyAnywhere\\\":true,\\\"applyAllPages\\\":false,\\\"isBirthdayNotEditable\\\":false,\\\"showWidget\\\":true,\\\"cachedVersion\\\":\\\"1762095519394\\\",\\\"socialLoginWidget\\\":{},\\\"pointRedemption\\\":{\\\"selectors\\\":{\\\"container\\\":null,\\\"drawer\\\":{\\\"cartTotalPrice\\\":\\\"#CartDrawer .totals__total-value\\\",\\\"container\\\":\\\"#CartDrawer .drawer__footer\\\"},\\\"cartTotalPrice\\\":null,\\\"cart\\\":{\\\"cartTotalPrice\\\":\\\"\\\",\\\"container\\\":\\\"\\\"}},\\\"display\\\":{\\\"drawer\\\":true,\\\"cart\\\":true},\\\"flags\\\":{\\\"showPointRedemptionInAllPages\\\":false}}}}\"\n }\n }\n },\n \"extensions\": {\n \"cost\": {\n \"requestedQueryCost\": 2,\n \"actualQueryCost\": 2,\n \"throttleStatus\": {\n \"maximumAvailable\": 2000,\n \"currentlyAvailable\": 1998,\n \"restoreRate\": 100\n }\n }\n }\n}"}],"_postman_id":"9f6e860e-ca5a-47a8-894c-50d269bb4878"},{"name":"REST","id":"1b04b621-1bf1-49e2-85ff-634ecb7c2163","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Shopify-Access-Token"},{"key":"value","value":"{{shopify-app-token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"url":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/metafields.json?namespace=akohub&key=checkout-redemption","urlObject":{"protocol":"https","path":["admin","api","{{shopify-api-version}}","metafields.json"],"host":["{{shopify-store}}"],"query":[{"key":"namespace","value":"akohub"},{"key":"key","value":"checkout-redemption"}],"variable":[]}},"response":[],"_postman_id":"1b04b621-1bf1-49e2-85ff-634ecb7c2163"}],"id":"3bf63ca9-9713-4cd1-b494-edf4f0487013","description":"The Ako Marketing app must be installed on your Shopify store.
\nThe points and checkout redemption settings can be accessed through the Shop metafields with namespace akohub and the key checkout-redemption. The data parsing is necessary because these values are stored as single-line text in Shopify.
The Ako Marketing app must be installed on your Shopify store.
\nTo create a Shopify order with the point redemption, you need to append a custom discount code to the discountCode of the order. The discount code format should be: redeem points: {{points}} ({{amount}} {{currencyCode}})
For example, if you'd like to redeem $10 USD with 100 points, please append the discount code redeem points: 100 (10 USD) while creating a new order.
This endpoint allows you to manually add or remove points from a customer's balance. You can identify the customer using either their customerId or customerEmail.
When you adjust points, you can provide a reason for the adjustment, set an expiration date for any points being added, and include an idempotency key to prevent accidental duplicate transactions. If a customer is not yet part of the loyalty program, they will be automatically enrolled when you make the first points adjustment.
\nBundled customer profile. Returns the base profile always; opt into per-feature blocks with\n?fields=. Designed to replace 5+ calls when painting a profile screen.
read_customers (base). Each requested field may add a scope.Path variable
\nQuery
\nPer-field scope expansion — points → none · vip → read_vip · storeCredit →\nread_store_credit · referral → read_referrals. A field requested without its scope fails\n403 FORBIDDEN (never silently dropped). On any block failure the whole request fails — no partial\nresponses.
Errors: 400 INVALID_REQUEST (unknown field) · 403 FORBIDDEN (missing scope) ·\n403 PROGRAM_DISABLED (feature off) · 404 RESOURCE_NOT_FOUND (customer missing, or referral\nwith no code yet) · 422 UNPROCESSABLE_ENTITY (storeCredit but shop lacks Shopify\nread_store_credit_accounts).
Paginated list of customers for incremental sync. Items use a slim shape — only fields available\nwithout a per-customer Shopify call. Use the dedicated per-resource endpoints for live or\nfeature-specific data.
\nread_customers (plus read_vip when filtering by vipTierLevel). Rate tier: read.Query
\n\n\n\n
birthday/gender/phoneare omitted when absent.points.balanceis the cached balance\n(can briefly lag the ledger — callGet customer/ the points endpoint for the authoritative\nvalue).vipis omitted withoutread_vipor when VIP is off.storeCreditandreferralare\nnever in the list. A points change reaches this endpoint'supdatedAtasynchronously, so run a\nperiodic full reconciliation rather than treatingupdatedAfteras exhaustive.
Errors: 400 INVALID_REQUEST (bad query) · 403 FORBIDDEN (vipTierLevel without read_vip).
Partial update of a customer's editable profile fields. Wraps the same internal profile syncer as
the storefront widget — propagating to Shopify, Klaviyo, and the loyalty record, and firing theupdateCustomerProfile event (which drives the complete-profile reward and an asynchronous VIP
recalculation). Updating birthday also re-schedules the birthday reward.
Scope: write_customers. Rate tier: write.
Identified by path customerId only. No idempotencyKey (a PATCH to fixed values is naturally
idempotent).
Body (all optional; at least one required)
\n\n\nOnly supplied fields change. Empty / omitted values are no-ops — a field cannot be cleared****through this endpoint. The response is the same base envelope as
\nGet customer, so you can
render \"saved just now\" with no follow-up read.
\n\nBirthday lock (
\n422). This only happens when the merchant has enabled \"birthday****non-editable after saving\" in their Customer Profile settings and the customer already has
a birthday. Setting a birthday for the first time always succeeds; only changing an existing
one is rejected. With the setting off (the default), birthday is freely editable. The lock exists
to stop customers gaming birthday rewards by repeatedly changing their birth date.
Errors: 400 INVALID_REQUEST (no recognized field / wrong type / bad birthday) ·403 FORBIDDEN (missing write_customers) · 404 RESOURCE_NOT_FOUND · 422 UNPROCESSABLE_ENTITY
(birthday locked, or Shopify rejected a field — details.fields maps field → message) ·500 UNKNOWN_ERROR (transient Shopify sync failure; DynamoDB change not committed — retry).
Per-order breakdown of the spend that counts toward VIP tier qualification inside the shop's\nrolling window, plus the date each order rolls out of it. Reads the same ledger the tier engine\nqualifies on, so the total here matches GET /customers/{customerId}/vip →\nprogress.orderAmountSpent (default qualification window). Exists so partners can build a\n\"spend N more before <date> to reach/keep <tier>\" reminder — something the aggregate alone\ncan't express, because the qualification total drifts downward day by day as old orders age out.
Scope: read_vip. Rate tier: read.
Identified by path customerId only (numeric or Customer GID). No query params — unlike\nGET /customers/{customerId}/vip, this endpoint always describes the qualification window.
No pagination: orders returns the complete in-window set in one response, because the\nroll-out math needs all of it. Typical customers return single digits to a few dozen rows;\na heavy repeat buyer on a high-frequency store can return several hundred. There is no hard\ncap — size your client accordingly rather than assuming a small array.
Response
\nwindow
orders[]
\n\nBuilding an \"upgrade-by\" reminder. Pick a deadline — typically
\norders[0].expiryDate, the\nnext roll-out. The still-valid total at that deadline =orderAmountSpent− theamountSpentof\nevery order whoseexpiryDate ≤ deadline. The shortfall = the next tier's\ncriteria.amountSpent.value(fromGET /vip/tiers) − that still-valid total. Which roll-out to\nremind before is your policy; the API just gives you every date.
\n\nLifetime VIP (**
\nExpire= lifetime**) returns no rows. There is no rolling window — the\nlower bound is fixed, so orders never roll out and a per-order reminder has nothing to say. You get\ncalculationPeriodDays: null,orders: [], and anorderAmountSpentcounted from the fixed lower\nbound.startsAtisnullonly when the shop set no CalculationDate (then the total is all-time);\notherwise it is that date. Derive the (static) shortfall fromorderAmountSpentvs the tier\nthreshold.
\n\n\n
orderAmountSpentcan exceed the sum oforders[]. A manual spend adjustment made without an\norder counts toward the total but has noordersrow. Reconcile againstorderAmountSpent, never\nagainst your own sum of the rows.
\n\nFreshness. These rows are live ledger reads, while
\ncurrentTieronGET /customers/{id}/vip\nis a cached snapshot updated by an async recalculation. Right after a qualifying order the totals\nhere can already clear the next threshold while the tier still reads low — that's \"pending recalc\",\nnot a mismatch.
Errors: 400 INVALID_REQUEST (customerId is neither numeric nor a Customer GID) ·\n403 FORBIDDEN (missing read_vip) · 403 PROGRAM_DISABLED (VIP is not enabled for this shop) ·\n404 RESOURCE_NOT_FOUND (no such customer on this shop).
The Ako Marketing app must be installed on your Shopify store.
\nAko Marketing Authentication
\nAko Marketing API uses the OAuth 2.0 Client Credentials Grant flow to authenticate requests.
\nTo get started, you will need a clientId and a clientSecret. Please contact us to have these credentials created for you.
The authentication process is as follows:
\nRequest an Access Token: Your application makes a POST request to our OAuth token endpoint, providing your clientId, clientSecret, the shop, and the grantType.
Receive the Access Token: If the credentials are valid, the API will return a short-lived JSON Web Token (JWT) as an accessToken. This token is specifically scoped to the requested shop.
Call the API: Include this accessToken in the Authorization header of all subsequent API requests, using the Bearer scheme.
The access token expires in 1 hour. Your application should be prepared to request a new token when the old one expires.
\nConventions
\nError codes: INVALID_REQUEST (400) · INVALID_TOKEN (401) · FORBIDDEN (403, scope) ·PROGRAM_DISABLED (403, feature off) · RESOURCE_NOT_FOUND (404) · UNPROCESSABLE_ENTITY (422) ·TOO_MANY_REQUESTS (429) · UNKNOWN_ERROR (500).
The Adjust customer points API allows you to add points to a customer's point balance or subtract points from a customer's point balance.
\nYou can specify points you'd like to add or subtract, the point expiry date, the public note, and internal note.
\n","_postman_id":"1c0809c3-1a60-444b-9636-d2a69ce6e7b7"},{"name":"Get social login user id of customer","item":[{"name":"GraphQL","id":"856da721-2c44-414c-9848-f9d9595fcd5e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"body":{"mode":"graphql","graphql":{"query":"query {\n customer(id: \"gid://shopify/Customer/6511487451249\") {\n tags\n }\n}\n\n","variables":""}},"url":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/graphql.json","urlObject":{"protocol":"https","path":["admin","api","{{shopify-api-version}}","graphql.json"],"host":["{{shopify-store}}"],"query":[],"variable":[]}},"response":[{"id":"2956db9c-2952-43a5-8045-40c4b216d1ba","name":"Success","originalRequest":{"method":"POST","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"body":{"mode":"graphql","graphql":{"query":"query {\n customer(id: \"gid://shopify/Customer/6511487451249\") {\n tags\n }\n}\n\n","variables":""}},"url":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/graphql.json"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 25 Dec 2023 02:04:51 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Sorting-Hat-PodId","value":"112"},{"key":"X-Sorting-Hat-ShopId","value":"7648215153"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Referrer-Policy","value":"origin-when-cross-origin"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-ShopId","value":"7648215153"},{"key":"X-ShardId","value":"112"},{"key":"X-Stats-UserId","value":""},{"key":"X-Stats-ApiClientId","value":"6389563"},{"key":"X-Stats-ApiPermissionId","value":"356878549105"},{"key":"X-Shopify-API-Version","value":"2023-10"},{"key":"Content-Language","value":"en"},{"key":"Strict-Transport-Security","value":"max-age=7889238"},{"key":"Server-Timing","value":"processing;dur=79, graphql;desc=\"admin/query/other\""},{"key":"Server-Timing","value":"cfRequestDuration;dur=299.000025"},{"key":"X-Shopify-Stage","value":"production"},{"key":"Content-Security-Policy","value":"default-src 'self' data: blob: 'unsafe-inline' 'unsafe-eval' https://* shopify-pos://*; block-all-mixed-content; child-src 'self' https://* shopify-pos://*; connect-src 'self' wss://* https://*; frame-ancestors 'none'; img-src 'self' data: blob: https:; script-src https://cdn.shopify.com https://cdn.shopifycdn.net https://checkout.shopifycs.com https://api.stripe.com https://mpsnare.iesnare.com https://appcenter.intuit.com https://www.paypal.com https://js.braintreegateway.com https://c.paypal.com https://maps.googleapis.com https://www.google-analytics.com https://v.shopify.com 'self' 'unsafe-inline' 'unsafe-eval'; upgrade-insecure-requests; report-uri /csp-report?source%5Baction%5D=query&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Fgraphql&source%5Bsection%5D=admin_api&source%5Buuid%5D=832ca8e2-49dd-4eb7-bdad-cac4609be8db"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block; report=/xss-report?source%5Baction%5D=query&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Fgraphql&source%5Bsection%5D=admin_api&source%5Buuid%5D=832ca8e2-49dd-4eb7-bdad-cac4609be8db"},{"key":"X-Request-ID","value":"832ca8e2-49dd-4eb7-bdad-cac4609be8db"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=ALUbzXpTdqopBrTSL2ze7uiSIIQ0WNQwoJ03iy2SybBf79FEmUbCZ%2B8FnucL7%2FYxP0%2Bo%2F%2F8PFyZA5ZVJ3bja2lxrVu9V31Qc7qJ3Evab3krjj2DLfQ0TyWaVqN2iSfS%2BRHVyCROcFYLk3doCWNcmJac%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"83ad84024e174a6d-TPE"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"customer\": {\n \"tags\": [\n \"ako-tier-1\"\n ]\n }\n },\n \"extensions\": {\n \"cost\": {\n \"requestedQueryCost\": 1,\n \"actualQueryCost\": 1,\n \"throttleStatus\": {\n \"maximumAvailable\": 1000,\n \"currentlyAvailable\": 999,\n \"restoreRate\": 50\n }\n }\n }\n}"}],"_postman_id":"856da721-2c44-414c-9848-f9d9595fcd5e"},{"name":"REST","id":"b51f6f12-0c44-495c-9c1f-0a3aaf0335b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"url":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/customers/6511487451249.json?fields=tags\n","urlObject":{"protocol":"https","path":["admin","api","{{shopify-api-version}}","customers","6511487451249.json"],"host":["{{shopify-store}}"],"query":[{"key":"fields","value":"tags\n"}],"variable":[]}},"response":[{"id":"b0a23aad-ab44-4351-b5e0-656b4093e375","name":"Success","originalRequest":{"method":"GET","header":[{"key":"X-Shopify-Access-Token","value":"{{shopify-app-token}}","type":"text"}],"url":{"raw":"https://{{shopify-store}}/admin/api/{{shopify-api-version}}/customers/6511487451249.json?fields=tags\n","protocol":"https","host":["{{shopify-store}}"],"path":["admin","api","{{shopify-api-version}}","customers","6511487451249.json"],"query":[{"key":"fields","value":"tags\n"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 25 Dec 2023 02:06:40 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Sorting-Hat-PodId","value":"112"},{"key":"X-Sorting-Hat-ShopId","value":"7648215153"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Referrer-Policy","value":"origin-when-cross-origin"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-ShopId","value":"7648215153"},{"key":"X-ShardId","value":"112"},{"key":"X-Stats-UserId","value":""},{"key":"X-Stats-ApiClientId","value":"6389563"},{"key":"X-Stats-ApiPermissionId","value":"356878549105"},{"key":"X-Shopify-API-Version","value":"2023-10"},{"key":"HTTP_X_SHOPIFY_SHOP_API_CALL_LIMIT","value":"1/40"},{"key":"X-Shopify-Shop-Api-Call-Limit","value":"1/40"},{"key":"Strict-Transport-Security","value":"max-age=7889238"},{"key":"Server-Timing","value":"processing;dur=36"},{"key":"Server-Timing","value":"cfRequestDuration;dur=244.999886"},{"key":"X-Shopify-Stage","value":"production"},{"key":"Content-Security-Policy","value":"default-src 'self' data: blob: 'unsafe-inline' 'unsafe-eval' https://* shopify-pos://*; block-all-mixed-content; child-src 'self' https://* shopify-pos://*; connect-src 'self' wss://* https://*; frame-ancestors 'none'; img-src 'self' data: blob: https:; script-src https://cdn.shopify.com https://cdn.shopifycdn.net https://checkout.shopifycs.com https://api.stripe.com https://mpsnare.iesnare.com https://appcenter.intuit.com https://www.paypal.com https://js.braintreegateway.com https://c.paypal.com https://maps.googleapis.com https://www.google-analytics.com https://v.shopify.com 'self' 'unsafe-inline' 'unsafe-eval'; upgrade-insecure-requests; report-uri /csp-report?source%5Baction%5D=show&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Fcustomers&source%5Bsection%5D=admin_api&source%5Buuid%5D=89e861b1-5c96-4a7a-b2b9-1ffb62c522d6"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"1; mode=block; report=/xss-report?source%5Baction%5D=show&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Fcustomers&source%5Bsection%5D=admin_api&source%5Buuid%5D=89e861b1-5c96-4a7a-b2b9-1ffb62c522d6"},{"key":"X-Request-ID","value":"89e861b1-5c96-4a7a-b2b9-1ffb62c522d6"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=LYLee46AYEe5c31pI78kGzY%2B9ce2enCLF8p0LyPf0B5Is4jwDbM%2FQTEcvcuFH3xiycYv7yEhK3tzDKPfMev0VV6Su71RacXSVnm1uUQhy2QwBp3psE51H18o9toh5CDj0OW%2FsZiH%2BkfxTEqvi1szV7o%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"83ad86af39c74a6d-TPE"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"customer\": {\n \"tags\": \"ako-tier-1\"\n }\n}"}],"_postman_id":"b51f6f12-0c44-495c-9c1f-0a3aaf0335b3"}],"id":"919fd300-d6fa-45f6-8e95-46daf0c1d4ce","description":"The Ako Marketing app must be installed on your Shopify store.
\nThe Ako Marketing app must be installed on your Shopify store.
\nThe referral link is combined with the following 2 parts.
\nReferral link domain (which can be fetched with shop's metafields)
\nReferral Code (which can be fetched with customer's metafields)
\nThe format of the referral link of a customer is like this:
\n{{Referral link domain}}?ref={{Referral Code}}\n\nThe Ako CVS app must be installed on your Shopify store.
\nThe logistics and invoice information are added to the note_attributes of a Shopify order for reference. For detailed informaion, please refer to our help center.
The Ako CVS app must be installed on your Shopify store.
\nThe Ako CVS App marks important delivery status updates as tags to each order. Below is the list of key stages and possible tags.
\nA points balance moved. Change Type tells you how; Metadata.pointsChanged is the\nsigned amount (+ earn, − spend / refund / expire).
Source — order, signup, birthday, referral, referral_commission, review,\nvip_tier, ig_reels, claim, qr, flow, partner, manual (staff or public-API\nadjustment), api. Empty for checkout redemptions and expiry.Change Type — reward_grant (earn), reward_revoke (clawback, e.g. an order refund\nreversing earned points), redeem, refund, expire, adjust, transfer,\nmerge.MetadataA Shopify store-credit balance moved. Same shape as points/changed, in money instead of points,\nplus the Shopify-native account/transaction references.
Source — same values as points/changed.Change Type — reward_grant, reward_revoke, redeem, refund, adjust.MetadataA per-customer discount code was issued to this customer — either as a campaign reward or\nthrough Ako's public discount API. Read Source to tell which.
Because a discount moves no balance, this and rewards/granted are the only signals for a\ndiscount-type reward.
Source — a campaign source (signup, birthday, vip_tier, …) or reward when the\ncampaign source can't be resolved; api when issued through the public API; manual when Ako\nstaff issued it by hand.Change Type — always empty.Metadata\n\n","urlObject":{"protocol":"https","host":["akohub","com"],"query":[],"variable":[]}},"response":[{"id":"b99e1b4c-bc82-4cad-86a4-f1f1cb06131f","name":"Earn","originalRequest":{"method":"GET","header":[],"url":"https://akohub.com"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n \"customer_id\": 1234567890,\n \"Event Type\": \"discount/created\",\n \"Source\": \"signup\",\n \"Change Type\": \"\",\n \"Unique ID\": \"e05b9c3a7f14d286b0c95e73a1f8d642\",\n \"Event Date\": \"2026-06-29T08:00:00.000Z\",\n \"Trigger Date\": \"2026-06-29T08:00:01.100Z\",\n \"Metadata\": \"{\\\"rewardId\\\":\\\"rwd_9x2k\\\",\\\"campaignName\\\":\\\"Welcome gift\\\",\\\"rewardTitle\\\":\\\"10% off\\\",\\\"discountCode\\\":\\\"AKO-9F2K1\\\",\\\"discountClass\\\":\\\"order\\\",\\\"valueType\\\":\\\"percentage\\\",\\\"value\\\":\\\"10\\\",\\\"startsAt\\\":\\\"2026-06-29T08:00:00.000Z\\\",\\\"expiryDate\\\":\\\"2026-07-29T23:59:59.999Z\\\",\\\"correlationId\\\":\\\"1a4e8d0b6c39f752e8a1d4b7c0f3629e\\\"}\"\n}"}],"_postman_id":"7405f3d5-f8c4-42df-8591-7e877f6610dd"},{"name":"points/expiring","id":"6ed68f4d-7fb2-4d14-8ccf-a76c4bae60de","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://akohub.com","description":"Join on
\ndiscountCodeto pair this with the laterdiscount/usedevent.
A reminder that a customer's points are about to expire. Sent once, for the primary reminder\nonly (the last-chance reminder does not fire this event), and independently of whether the merchant\nhas expiry emails switched on.
\nSource / Change Type — both empty.Event Date — the moment the reminder was due, not when it was delivered.MetadataA reminder that one of the customer's discount codes is about to expire. Fires only while the code\nis still active; primary reminder only.
\nSource / Change Type — both empty.Event Date — the moment the reminder was due, not when it was delivered.MetadataThe customer used one of your per-customer discount codes in an order. One event per code, so an\norder using two codes delivers two events (de-dupe on Unique ID).
Public / segment-wide codes are not covered — only codes issued to a specific customer.
\nSource / Change Type — both empty.Metadata\n\n","urlObject":{"protocol":"https","host":["akohub","com"],"query":[],"variable":[]}},"response":[{"id":"1a6145ce-18d3-428b-b76f-f24b858fc092","name":"Used","originalRequest":{"method":"GET","header":[],"url":"https://akohub.com"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n \"customer_id\": 1234567890,\n \"Event Type\": \"discount/used\",\n \"Source\": \"\",\n \"Change Type\": \"\",\n \"Unique ID\": \"af58120d9c637be4a2f80d51c9b3e746\",\n \"Event Date\": \"2026-07-14T16:03:22.000Z\",\n \"Trigger Date\": \"2026-07-14T16:03:23.100Z\",\n \"Metadata\": \"{\\\"discountCode\\\":\\\"AKO-9F2K1\\\",\\\"orderId\\\":\\\"6201234577777\\\",\\\"rewardId\\\":\\\"rwd_9x2k\\\",\\\"rewardTitle\\\":\\\"10% off\\\"}\"\n}"}],"_postman_id":"47108dd0-f789-4e86-96de-5ea0398fc44a"},{"name":"store_credit/expiring","id":"8907e65e-4964-40ba-a79a-86036de8f963","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://akohub.com","description":"The discount's type and value are not repeated here — join on
\ndiscountCodeto the\ndiscount/createdevent, which carries them.
A reminder that a customer's store credit is about to expire. Primary reminder only; fires\nindependently of the expiry email.
\nSource / Change Type — both empty.Event Date — the moment the reminder was due, not when it was delivered.MetadataThe customer's VIP tier changed. This is the qualification event — any reward attached to the\nnew tier arrives separately on rewards/granted / the asset topics, sharing the same\ncorrelationId.
Source / Change Type — both empty.MetadataThe reward lens. A campaign reward was granted — regardless of type. A campaign can grant\nseveral rewards at once (points + store credit + a discount code); they all ride in one event as\nthe rewards array, not one event per reward.
Use this for \"the customer got a reward\" automations. For \"a balance moved\", use the asset topics\ninstead — never subscribe both to the same reaction.
\nFires only for configured rewards. Staff corrections (Source = manual) and programmatic\nissuance (Source = api) do not fire it.
Source — order · signup · review · referral · referral_commission · birthday ·\nvip_tier · ig_reels · claim · qr · flow · partner.Change Type — always empty (the roll-up isn't a single balance move).Metadatarewards[] entryA previously granted reward was clawed back — the mirror of rewards/granted, same bundled shape.\nTypical causes: an order refund reversing earned points, or a VIP rollback undoing tier rewards.
Points and store credit only. A discount reward cannot be clawed back once issued, so revoking\none emits no event.
\nSource — always empty on this topic. Identify what was reversed from rewardId /\ncampaignName in Metadata instead.Change Type — always empty.MetadataThe customer's birthday came round. Reward-independent: it fires whether or not a birthday reward\nis configured, and any reward arrives separately on rewards/granted.
Source / Change Type — both empty.Metadata — empty (\"\"). Event Date is the scheduled birthday date.The customer completed their loyalty profile — the moment both gender and birthday are on\nrecord. Fires only on the incomplete → complete transition, never on a later edit.
\nSource / Change Type — both empty.Metadata — empty (\"\").The customer connected a social account to their loyalty profile. One event per provider; fires\nwhether or not a social-login reward is configured.
\nSource / Change Type — both empty.MetadataA customer joined the loyalty program (fired on Shopify's customers/create). Fires whether or****not a signup reward is configured — any reward arrives separately on rewards/granted.
Source / Change Type — both empty.
Metadata — empty (\"\"). Everything you need is customer_id + Event Date.
The customer submitted a product review (via Judge.me). Fires on review creation only — an edit\nis not a new review — and only when the review carries a customer reference.
\nSource / Change Type — both empty.MetadataA referral converted. Metadata.role tells you which side of the referral this event is about,\nand customer_id is always that side's customer:
role = referred — the referred friend signed up with a referral link. customer_id = the new\ncustomer.role = referrer — a referred friend placed a qualifying order. customer_id = the referrer.Fires whether or not a referral reward is configured.
\nSource / Change Type — both empty.MetadataThe customer spent points to get something. Metadata.redeemType says what:
product — redeemed a reward product;orderDiscount — applied points as a discount at checkout;discountCode — redeemed points for a discount code.The matching balance move fires separately as points/changed with Change Type = redeem — this is\nthe redemption lens, don't subscribe both to the same reaction.
Source / Change Type — both empty.MetadataA redeemed item's status changed — the lifecycle of something the customer already redeemed. This\nis not a reward clawback (that's rewards/revoked).
Source / Change Type — both empty.Metadata\n\n","urlObject":{"protocol":"https","host":["akohub","com"],"query":[],"variable":[]}},"response":[{"id":"963731e2-5561-4dff-bcb7-dec303f143ac","name":"Redeemed a reward product","originalRequest":{"method":"GET","header":[],"url":"https://akohub.com"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n \"customer_id\": 1234567890,\n \"Event Type\": \"redemption/updated\",\n \"Source\": \"\",\n \"Change Type\": \"\",\n \"Unique ID\": \"07e3a95c1b8df2604a7c05e93b1d8246\",\n \"Event Date\": \"2026-07-20T08:31:17.000Z\",\n \"Trigger Date\": \"2026-07-20T08:31:18.400Z\",\n \"Metadata\": \"{\\\"status\\\":\\\"used\\\",\\\"redeemType\\\":\\\"product\\\",\\\"quantity\\\":1,\\\"rewardId\\\":\\\"rwd_tee1\\\",\\\"variantId\\\":\\\"gid://shopify/ProductVariant/44556677\\\",\\\"productTitle\\\":\\\"Mystery Tee\\\",\\\"variantTitle\\\":\\\"Large / Black\\\",\\\"orderId\\\":\\\"6201234599123\\\"}\"\n}"}],"_postman_id":"1646ab80-e989-4672-8739-34138e3814ba"}],"id":"e3636cab-fadd-477c-95a0-3d3e71c6ad36","description":"A refund's points return fires separately as
\npoints/changedwithChange Type = refund.
These are events Ako sends to you through Shopify Flow when something happens in a
customer's loyalty program — not endpoints you call. You react to them inside Shopify Flow: send an
email, add a tag, POST to your own endpoint, or run an Ako action.
Every topic in this folder arrives through one Shopify Flow trigger — \"Loyalty Event\"
(provided by the Ako app). You tell the topics apart with the Event Type field. The requests
below are documentation only: each one shows the exact payload one topic delivers.
In Shopify, open Flow → Create workflow.
\nTrigger: choose Loyalty Event (from Ako).
\nCondition: branch on the Event Type trigger field:
Equals points/changed → one specific topic.
Starts with points/ → a whole namespace (here, both points/changed and points/expiring).
Narrow further with Source (why it fired) and Change Type (how a balance moved).
Action: any Flow action — Shopify's own (send email, add/remove tag, …), a third-party
connector, or one of Ako's inbound actions (Award Points, Award Store Credit, Adjust VIP Tier,
Custom Reward).
Event Type, Source, and Change Type are the only fields a Flow condition can read
directly. Everything else rides in Metadata as a JSON string, which Flow conditions
cannot look inside.
Metadata — pick one of three patternsInsert the trigger fields into a Run-code input or an HTTP body with Flow's variable picker —Event Type, Source, Change Type, Unique ID, Event Date, Trigger Date, Metadata are all
available there.
\n\nDe-duplicate on
\nUnique ID****. Delivery is at-least-once. CompareUnique IDfor equality
(don't parse it — it's an opaque hash). An emptyUnique IDmeans \"do not de-dupe\".
Flow Events are opt-in and enabled by Ako, not self-serve. A topic is delivered only when
both gates pass: (1) Flow Events is enabled for your shop, and (2) the specific topic is on your
shop's subscription list.
👉 To turn these on, contact your Ako account manager (or support@akohub.com****) with your shop
domain and the topics you want.
The trigger always carries these top-level fields; a field with no value is \"\".
Source and Change Type are promoted out of Metadata — they appear as top-level fields
only, never inside the JSON.
Source values — order · signup · review · referral · referral_commission ·birthday · vip_tier · ig_reels · claim · qr · flow · partner · manual · api
(plus reward as a fallback on discount/created).
Change Type values — reward_grant (earn) · reward_revoke (clawback) · redeem ·refund · expire · adjust · transfer · merge. There is no separate \"earn\" type: earning on
an order is reward_grant with Source = order.
Three rules, applied on every topic, so a field name never changes type between topics:
an amount is a decimal string, an id is a string, a count is a number. Parse amounts
with Number() before doing arithmetic.
A reward grant emits two views of the same fact:
\nthe reward lens — rewards/granted: type-agnostic, one bundled event listing every reward in
the grant;
the asset lens — points/changed, store_credit/changed, discount/created: one event per
balance/asset that moved.
They share a correlationId in Metadata so you can join them. Pick one lens per automation —
subscribing both to the same action double-fires. Use the reward lens for \"any reward\" automations,
the asset lens for \"a balance moved\".