Shopify REST Admin API
✓ Official Vendor SpecE CommerceStorefrontapiKey, oauth2273 EndpointsREST
For Agents
Manage Shopify store operations including products, orders, customers, inventory, and fulfillments. Supports 273 endpoints covering the complete e-commerce lifecycle from catalog to post-purchase.
Use for: I need to create a new product with multiple variants and images, List all unfulfilled orders from the last 7 days, Adjust inventory quantity for a specific variant at a warehouse location, I want to apply a percentage discount to a collection of products
Not supported: Does not handle payment processing, email marketing, or shipping label generation — use for store administration and catalog management only.
Expose full programmatic control over Shopify stores — products, variants, inventory, orders, fulfillments, customers, discounts, themes, and webhooks — through 273 REST endpoints. Supports multi-location inventory management, automated order workflows, and real-time event subscriptions for building custom storefronts, ERP integrations, and marketplace connectors.
Install Jentic One Beta
Connect the Shopify REST Admin API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Shopify REST Admin API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Shopify REST Admin API.
Publish and update product listings with variants, images, and metafields across multiple sales channels
Process orders end-to-end from draft creation through fulfillment and refund calculation
Adjust inventory levels across multiple warehouse locations in real time
Search and segment customers by saved searches and tag-based filters
Configure automated discount rules with price rules and batch-generated codes
Subscribe to store events via webhooks for real-time order and inventory sync
Manage theme assets and content pages for headless or hybrid storefronts
Use Cases
Patterns agents use Shopify REST Admin API for, with concrete tasks.
★ AI Agent Order Processing
AI agents use the Shopify Admin API through Jentic to automate order management workflows. An agent can retrieve new orders, create fulfillments with tracking numbers, process refunds for returned items, and update order notes — all without manual admin panel interaction. The 273-endpoint surface covers the complete order lifecycle from draft creation to post-purchase follow-up.
Retrieve all unfulfilled orders from the last 24 hours and create a fulfillment with tracking number 1Z999AA10123456784 for order #1001
Product Catalog Synchronization
Synchronize product catalogs between Shopify and external systems such as ERPs, marketplaces, or warehouse management tools. The API provides endpoints to list products with pagination, create new products with variants and images, update pricing and inventory, and retrieve collection memberships. Supports bulk operations through batch endpoints for high-volume catalog updates.
Create a new product titled 'Wireless Headphones' with two variants (Black, White) priced at $79.99 each, and upload a product image from a URL
Multi-Location Inventory Management
Track and adjust stock levels across multiple physical locations using Shopify's inventory endpoints. Set available quantities per variant per location, connect inventory items to fulfillment services, and receive real-time inventory adjustment confirmations. Supports the connect, set, and adjust operations for precise stock control across warehouses, retail stores, and drop-ship partners.
Set inventory level for variant ID 808950810 to 50 units at location ID 905684977 and verify the adjustment succeeded
Customer Segmentation and Outreach
Segment customers by purchase history, tags, and custom attributes using Shopify's customer search and saved search endpoints. Retrieve customer addresses, order history, and send account invitations. Build targeted marketing lists or trigger personalized communications based on customer behavior patterns extracted through the API.
Search for customers with the tag 'VIP' who have placed orders in the last 30 days and retrieve their email addresses
Automated Discount Campaigns
Create and manage promotional campaigns programmatically using price rules and discount codes. Generate percentage or fixed-amount discounts, set usage limits, schedule start and end dates, and batch-create unique codes for distribution. The API supports prerequisite rules for minimum purchase amounts and entitled collections for targeted promotions.
Create a price rule for 20% off orders over $100 and generate a batch of 500 unique discount codes with prefix SUMMER
Key Endpoints
273 endpoints — expose full programmatic control over shopify stores — products, variants, inventory, orders, fulfillments, customers, discounts, themes, and webhooks — through 273 rest endpoints.
METHOD
PATH
DESCRIPTION
POST
/products.json
Create a new product with variants and images
GET
/orders.json
List orders with filtering by status, date, and fields
POST
/orders/{order_id}/fulfillments.json
Create a fulfillment for an order
POST
/inventory_levels/adjust.json
Adjust inventory at a location
GET
/customers/search.json
Search customers by query string
POST
/webhooks.json
Register a webhook subscription
POST
/price_rules.json
Create a discount price rule
POST
/draft_orders/{draft_order_id}/complete.json
Complete a draft order into a real order
POST
/products.json
Create a new product with variants and images
GET
/orders.json
List orders with filtering by status, date, and fields
POST
/orders/{order_id}/fulfillments.json
Create a fulfillment for an order
POST
/inventory_levels/adjust.json
Adjust inventory at a location
GET
/customers/search.json
Search customers by query string
POST
/webhooks.json
Register a webhook subscription
POST
/price_rules.json
Create a discount price rule
POST
/draft_orders/{draft_order_id}/complete.json
Complete a draft order into a real order
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Shopify OAuth tokens and API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens per store — raw X-Shopify-Access-Token values never enter the agent's context window.
Intent-based discovery
Agents search by intent (e.g., 'create a shopify product with variants') and Jentic returns matching Shopify Admin API operations with full request/response schemas, so the agent calls the right endpoint without browsing Shopify's documentation.
Time to first call
Direct Shopify integration: 3-7 days for OAuth flow, webhook handling, rate limit management, and error recovery. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Complementary
Stripe API
Payment processing for custom checkout flows outside Shopify Payments
Use when the merchant needs a custom payment gateway, multi-party payouts, or operates in regions where Shopify Payments is unavailable.
FAQs
Specific to using Shopify REST Admin API through Jentic.
What authentication does the Shopify REST Admin API use?
The Shopify Admin API supports OAuth 2.0 for public apps and custom app API keys passed via the X-Shopify-Access-Token header. Through Jentic, your OAuth tokens and access credentials are stored encrypted in the MAXsystem vault — agents receive scoped tokens without exposure to raw secrets.
Can I adjust inventory across multiple Shopify locations with this API?
Yes. Use the /inventory_levels/adjust.json endpoint to increment or decrement stock at a specific location. The /inventory_levels/set.json endpoint sets absolute quantities. Both require the inventory_item_id and location_id parameters. The /locations.json endpoint lists all configured warehouse and retail locations.
What are the rate limits for the Shopify Admin API?
Shopify enforces a leaky bucket rate limit of 40 requests per app per store for REST endpoints, refilling at 2 requests per second. Exceeding the limit returns a 429 Too Many Requests response with a Retry-After header. The API also returns X-Shopify-Shop-Api-Call-Limit headers showing current bucket usage.
How do I create a product with variants through Jentic?
Search Jentic for 'create a shopify product with variants' to discover the POST /products.json operation. The schema shows you need a product object with title, variants array (each with price, sku, and option values), and optional images. Execute through Jentic and the product appears in the Shopify admin immediately.
How many endpoints does the Shopify Admin API have?
The Shopify REST Admin API exposes 273 endpoints covering products, orders, customers, inventory, fulfillments, discounts, themes, blogs, pages, metafields, webhooks, and Shopify Payments. This breadth allows agents to handle nearly any store operation without switching to a different API.
Can I subscribe to real-time order events with webhooks?
Yes. POST to /webhooks.json with a topic (e.g., orders/create, orders/paid, orders/fulfilled) and a callback URL. The API supports over 50 webhook topics. Use GET /webhooks.json to list active subscriptions and DELETE /webhooks/{webhook_id}.json to remove them.
Is the Shopify Admin API free to use?
Access to the Shopify Admin API is included with any Shopify plan (starting at $39/month). There are no separate API fees. Rate limits scale with your plan tier. Custom apps on development stores have free unlimited API access for testing before going live.
GET STARTED