> ## Documentation Index > Fetch the complete documentation index at: https://docs.omnicommerce.ai/llms.txt > Use this file to discover all available pages before exploring further. # Assign Product Marketplace Stores > Requires catalog:write. Assign one or more connected stores per marketplace to 1–100 products, including marketplace-only drafts. Get exact store IDs and countries from GET /api/v1/marketplaces/connected. ### Store selection Each product family is updated independently. Existing listings keep their remote identities. Reusing a store ID across countries requires storeCountries to identify the connection. Each product can use only one country per store ID. Copy compatible taxonomy from an existing sourceStoreId when supplied. ### Publish assigned stores The response includes exact data.storeTargets for publishing the successful products. HTTP 207 means at least one product failed. Inspect each result before passing those storeTargets to POST /api/v1/products/{productId}/publish. ## OpenAPI ````yaml /openapi.json post /api/v1/products/marketplace-stores openapi: 3.1.0 info: title: OmniCommerce API version: 1.0.0 license: name: Proprietary url: https://omnicommerce.sg/terms description: >- OmniCommerce API surface for agents and developer integrations. Includes public endpoints (merchant discovery, product search, compare, catalog, ACO retrieval) and authenticated endpoints (product management via API key Bearer tokens). servers: - url: https://omnicommerce.ai description: Production - url: http://localhost:3000 description: Local development security: [] tags: - name: agentic-checkout description: Merchant-fulfilled agentic checkout x-group: Agentic Checkout - name: agents description: agents x-group: Agents - name: analytics description: Sales performance across marketplaces x-group: Analytics - name: aops description: Agent operating procedures x-group: AOPs - name: branding description: branding x-group: Branding - name: campaigns description: Campaign briefs, offer windows, and marketplace runs x-group: Campaigns - name: catalog description: catalog x-group: Catalog - name: commerce description: commerce x-group: Commerce - name: developer-platform description: Authenticated developer platform APIs x-group: Developer Platform - name: documents description: Knowledge base document uploads x-group: Knowledge Base - name: follow-ups description: follow-ups x-group: Follow Ups - name: inventory description: Inventory quantities, planning signals, and marketplace listing absence x-group: Inventory - name: looks description: AI-styled product looks x-group: Looks - name: oauth description: OAuth token endpoints x-group: OAuth - name: orders description: Workspace and agentic orders x-group: Orders - name: organizations description: Organization management x-group: Organizations - name: price-books description: Marketplace list-price markup rules x-group: Price Books - name: products description: Product CRUD, bulk import, enrichment, publish, and delist x-group: Products - name: promotions description: Central promotions and marketplace sync x-group: Promotions - name: public-agent description: Public agent discovery and catalog APIs x-group: Public Agent - name: returns description: returns x-group: Returns - name: reviews description: Marketplace product reviews and seller replies x-group: Reviews - name: scripts description: scripts x-group: Scripts - name: settlements description: settlements x-group: Settlements - name: ucp description: Universal Commerce Protocol x-group: UCP paths: /api/v1/products/marketplace-stores: post: tags: - products summary: Assign Product Marketplace Stores description: >- Requires catalog:write. Assign one or more connected stores per marketplace to 1–100 products, including marketplace-only drafts. Get exact store IDs and countries from GET /api/v1/marketplaces/connected. ### Store selection Each product family is updated independently. Existing listings keep their remote identities. Reusing a store ID across countries requires storeCountries to identify the connection. Each product can use only one country per store ID. Copy compatible taxonomy from an existing sourceStoreId when supplied. ### Publish assigned stores The response includes exact data.storeTargets for publishing the successful products. HTTP 207 means at least one product failed. Inspect each result before passing those storeTargets to POST /api/v1/products/{productId}/publish. operationId: post_v1_products_marketplace_stores requestBody: required: true content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: productIds: minItems: 1 maxItems: 100 type: array items: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ selections: minItems: 1 maxItems: 8 type: array items: type: object properties: marketplace: type: string enum: - shopee - lazada - tiktok - shopify - whatsapp - zalora - amazon - ebay storeIds: minItems: 1 maxItems: 100 type: array items: type: string minLength: 1 maxLength: 255 sourceStoreId: type: string minLength: 1 storeCountries: type: object propertyNames: type: string minLength: 1 maxLength: 255 additionalProperties: type: string minLength: 2 maxLength: 80 required: - marketplace - storeIds additionalProperties: false organizationId: description: >- Required for session auth; derived from the credential for bearer auth. type: string minLength: 1 maxLength: 255 required: - productIds - selections additionalProperties: false example: productIds: - 10480f82-762d-45c5-a427-af809b2477f6 selections: - marketplace: shopify storeIds: - shop-1 - shop-2 responses: '200': description: Store assignment results in requested product order. content: application/json: schema: type: object required: - ok - status - data properties: ok: type: boolean status: type: string enum: - completed - failed data: type: object required: - success - productIds - storeTargets - succeededCount - failedCount - results properties: success: type: boolean productIds: type: array items: type: string storeTargets: $schema: https://json-schema.org/draft/2020-12/schema minItems: 1 maxItems: 800 type: array items: type: object additionalProperties: false required: - marketplace - storeId properties: marketplace: type: string enum: - shopee - lazada - tiktok - shopify - whatsapp - zalora - amazon - ebay storeId: type: string minLength: 1 maxLength: 255 succeededCount: type: integer minimum: 0 failedCount: type: integer minimum: 0 results: type: array items: type: object required: - productId - success properties: productId: type: string success: type: boolean storeIds: type: array items: type: string error: type: string '207': description: One or more product assignments failed. content: application/json: schema: type: object required: - ok - status - data properties: ok: type: boolean status: type: string enum: - completed - failed data: type: object required: - success - productIds - storeTargets - succeededCount - failedCount - results properties: success: type: boolean productIds: type: array items: type: string storeTargets: $schema: https://json-schema.org/draft/2020-12/schema minItems: 1 maxItems: 800 type: array items: type: object additionalProperties: false required: - marketplace - storeId properties: marketplace: type: string enum: - shopee - lazada - tiktok - shopify - whatsapp - zalora - amazon - ebay storeId: type: string minLength: 1 maxLength: 255 succeededCount: type: integer minimum: 0 failedCount: type: integer minimum: 0 results: type: array items: type: object required: - productId - success properties: productId: type: string success: type: boolean storeIds: type: array items: type: string error: type: string '400': description: >- Invalid request or queue preparation failed. Inspect the error before resubmitting. '401': description: Missing or invalid credentials. '403': description: >- Missing scope, insufficient permission, organization mismatch, or inactive organization. '429': description: Rate limit exceeded. security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.