
Bigcommerce Api
Build production BigCommerce integrations, apps, and headless storefronts with REST APIs and GraphQL
What You Can Do
You can architect and implement production-ready BigCommerce integrations using REST APIs, GraphQL Storefront API, and webhook automation. This skill guides you through API versioning decisions, OAuth authentication flows, rate limit management, multi-storefront channel architecture, and the complete app development lifecycle—from initial authentication setup through deploying integrations that handle real transactional data at scale.
Features
Know when to use V2 vs V3 endpoints for catalogs, customers, orders, and transactions
Implement store-level, app-level, and account-level credentials securely for single and multi-store setups
Monitor rate limits across REST APIs, Payments API, and GraphQL with exponential backoff retry logic
Handle channel_id assignment, cross-storefront products, orders, and checkouts correctly
Build headless storefronts with optimized GraphQL queries for products, carts, and checkout
Design webhook consumers for orders, products, and customer events with proper signature validation
Parse BigCommerce error responses and troubleshoot authentication, rate limits, and data sync issues
Example Output
Example 1: API Endpoint Decision
Task: Fetch product with metafields
Recommendation: Use V3 GET /catalog/products (supports metafields)
Not V2: V2 endpoints lack metafield support
Example 2: OAuth Setup for Marketplace App
Flow: App registration → Authorization code flow → Access token storage
Header: Authorization: Bearer {access_token}
Scope: store_v2_products store_v2_orders store_v2_customers
Example 3: Multi-Storefront Product Assignment
Step 1: Check channel_id (default storefront = 1)
Step 2: POST /catalog/products with channel_assignments array
Step 3: Verify product visibility across all assigned channels
What's Included
- SKILL.md instruction file: Complete BigCommerce API reference with essential principles, authentication models, and rate limit guidance
- API versioning decision tree: Quick reference for choosing V2 vs V3 endpoints by resource type
- OAuth flow templates: Store-level, app-level, and account-level credential setup patterns
- Rate limit monitoring checklist: Headers to watch and exponential backoff implementation
- Multi-storefront architecture guide: Channel assignment, product visibility, and order routing patterns
Who It's For
- Backend engineers building BigCommerce integrations and marketplace apps
- Full-stack developers creating headless storefronts with GraphQL
- Platform architects designing multi-storefront and multi-channel systems
- E-commerce developers automating order management, inventory sync, and customer data flows
- SaaS product teams building BigCommerce connectors and integrations
Best For
- Choosing between REST API V2 and V3 for specific operations
- Implementing OAuth authentication for apps and integrations
- Managing rate limits and implementing retry logic
- Building multi-storefront product and order management systems
- Designing webhook consumers for real-time event handling
- Debugging API authentication, data validation, and sync errors






