Shopify - Mavera

Shopify holds your commerce truth — who buys, what they buy, how often they return, and where they drop off. These eight jobs pull that data through Mavera’s surfaces (Custom Personas, Mave Agent, Focus Groups, Generate, Brand Voices) so your personas reflect real purchasing behavior, your content matches actual inventory priorities, and your campaigns are informed by synthetic audience reactions grounded in real customer data.

API Reference Card

Detail	Value
Base URL	`https://{store}.myshopify.com/admin/api/2024-10/graphql.json`
Auth	OAuth 2.0 — `X-Shopify-Access-Token` header
Rate limits	GraphQL: 50 pts/sec (Standard), 500 pts/sec (Shopify Plus)
REST fallback	`https://{store}.myshopify.com/admin/api/2024-10/{resource}.json`
Mavera base	`https://app.mavera.io/api/v1`
Mavera auth	`Authorization: Bearer mvra_live_...`

All examples use three environment variables: SHOPIFY_STORE (your myshopify.com subdomain, e.g. acme-store), SHOPIFY_ACCESS_TOKEN (private app access token starting with shpat_), and MAVERA_API_KEY. Python examples use requests; JavaScript examples use fetch. GraphQL queries target the 2024-10 API version.

Prerequisites

Shopify private app with required scopes

Create a custom app in Shopify Admin → Settings → Apps and sales channels → Develop apps. Grant scopes: read_customers, read_orders, read_products, read_inventory, read_checkouts. Copy the Admin API access token (starts with shpat_).

Mavera API key

Get your key from Mavera dashboard. The key starts with mvra_live_.

Install dependencies

pip install requests openai

Environment variables

export SHOPIFY_STORE="acme-store"
export SHOPIFY_ACCESS_TOKEN="shpat_xxxxx"
export MAVERA_API_KEY="mvra_live_xxxxx"

Jobs

#	Job	Shopify Data	Mavera Surface	Output
1	Customer Cohort → Persona Pipeline	Customers with order history	Custom Personas	Cohort-segmented persona library
2	Product Review Analysis	Product metafields / Judge.me reviews	Responses	Sentiment + theme breakdown per product
3	Product Collection → Content Generation	Collection products	Brand Voices + Generate	Marketing copy with brand-consistent voice
4	Abandoned Cart → Focus Group	Abandoned checkouts	Focus Groups	Abandonment reason insights by segment
5	Seasonal Sales → Campaign Planning	Historical orders by month	Mave Agent	Data-driven seasonal campaign calendar
6	Product Bundling Validation	Orders with line items	Focus Groups	Bundle concept validation scores
7	Inventory-Aware Content Prioritization	Inventory levels by location	Generate	Prioritized content for high-stock items
8	Customer Metafield → Persona Enrichment	Customer metafields	Custom Personas	Enriched personas with loyalty + preference data

Rate Limits & Production Notes

Concern	Shopify Limit	Recommendation
GraphQL cost	50 pts/sec (Standard), 500 pts/sec (Plus)	Check `extensions.cost.throttleStatus` in every response
REST API	2 req/sec (Standard), 20 req/sec (Plus)	Add 500ms sleep between REST calls
Bulk operations	1 concurrent bulk op per app	Use for > 10k records instead of pagination
Webhook delivery	Push-based	Consider webhooks for real-time triggers
Mavera rate limit	Varies by plan	Exponential backoff on `429` responses

Before going to production: store tokens in a secrets manager (never commit them), implement exponential backoff with jitter (start 1s, double, cap 30s), use Shopify Bulk Operations for 10k+ records, log all API responses for auditing, test on a development store first, and pin your API version to 2024-10.

Production Checklist

Secrets in env vars or secrets manager
Exponential backoff with jitter on all API calls
Bulk operations for datasets > 10k records
Structured logging and error alerting
Tested on Shopify development store
API version pinned to 2024-10; rate limit headers monitored
Pagination cursors handled for all list endpoints

Shopify GraphQL Admin API

Official GraphQL reference with schema explorer.

Mavera API Reference

Personas, focus groups, brand voices, and generations.

Shopify Bulk Operations

Async queries for large datasets.

Integration Quick Reference

Cross-platform patterns for all Mavera integrations.

​API Reference Card

​Prerequisites

​Jobs

​Rate Limits & Production Notes

​Production Checklist

Shopify GraphQL Admin API

Mavera API Reference

Shopify Bulk Operations

Integration Quick Reference

API Reference Card

Prerequisites

Jobs

Rate Limits & Production Notes

Production Checklist