The Marketplace Suppliers API enables approved business partners to manage supplier profiles within Wix's marketplace ecosystem. Suppliers are individuals or companies that provide products to marketplace providers, who then sell those products to end users. This API provides comprehensive CRUD operations, bulk management capabilities, and advanced tagging functionality for organizing supplier data at scale.
With the Marketplace Suppliers API, you can:
- Create and manage individual supplier profiles with detailed information including location, ratings, and trust status.
- Perform bulk operations on up to 100 suppliers simultaneously for efficient mass data management.
- Organize suppliers using public and private tags with support for filter-based bulk operations.
- Listen to domain events for real-time synchronization across multiple systems.
- Query suppliers using advanced filtering, sorting, and cursor-based pagination.
This API is available only to approved Wix business partners and requires a signed business agreement with Wix. To apply for partnership, contact jills@wix.com with a short description of your product and integration goals.
Access to this API is limited to ensure that integrations meet Wix's product quality, data security, and user experience standards. Each request is reviewed individually based on the partner's product characteristics, technical capabilities, and alignment with Wix's ecosystem.
If your application does not meet the criteria for partnership, consider publishing your integration via the Wix App Market, which provides a public route for developers to make their products available to Wix users.
It's important to note the following points before starting to code:
- Business agreement required: Access to this API requires a signed business agreement and implementation plan with Wix.
- App ID assignment: When you create a supplier, the
appId field is automatically set to the ID of your calling application. This tracks which provider app manages each supplier.
- Revision-based concurrency control: All update operations require passing the current revision number to prevent conflicting changes. If your revision is outdated, the request fails with an error, and you must fetch the current supplier state before retrying.
- Bulk operation limits: Maximum 100 suppliers per bulk request and 100 suppliers per query request. For operations on more than 100 suppliers, split them into multiple batches. For unlimited tag updates across many suppliers, use the filter-based tag update endpoint which processes asynchronously.
- Tag assignment precedence: In bulk tag operations, if a tag appears in both assign and unassign lists, assignment takes precedence. This follows platform-wide standards for consistency across all Wix APIs.
- Rating consistency: When managing supplier ratings, always update both
rating and reviewCount fields together to maintain data consistency.
- Supplier business models: Dropshipping suppliers ship directly to end customers while wholesale suppliers ship in bulk to providers who fulfill orders. These types determine your fulfillment workflow integration.
Typical use cases for this API include:
- Supplier: An individual or company that provides products to marketplace providers, enabling them to sell those products to end users.
- Provider: The middle tier in the marketplace ecosystem that purchases from suppliers and sells to end users.
- Verification status: Boolean
verified field indicating whether a supplier has passed validation processes.
- Supplier type: Business model classification, either
DROPSHIPPING or WHOLESALE, that determines fulfillment approach. Dropshipping suppliers ship directly to end customers; wholesale suppliers ship in bulk to providers.
- App ID: Read-only identifier automatically assigned when creating a supplier, tracking which provider application is responsible for managing the supplier and its products.