{"pageKey":"Developers","slug":"developers","locale":"en-US","localeResolved":"en-US","fallbackApplied":false,"version":"developers@2026-10-07T21:32:57.288Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/en-us/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"Developer Hub: Merchandise APIs, OpenAPI & MCP | MerchandAise","description":"Build custom merchandise integrations with MerchandAise APIs. Explore OpenAPI docs, community embeds, supplier workflows, enterprise SSO and MCP tools.","sections":[{"heading":"MerchandAise developer hub","paragraphs":["Connect your website, business systems or AI assistant to MerchandAise. Explore APIs for product design, community storefronts, supplier operations and company identity, with OpenAPI specifications and MCP documentation to guide your integration."]},{"heading":"Built for the systems around your merchandise program","items":[{"title":"Community operators","description":"Launch embedded storefronts, configurator handoffs, and community flows inside club, league, and company sites with versioned public contracts."},{"title":"Enterprise teams and platform partners","description":"Connect procurement portals, identity systems, and internal operations to merchandise workflows without rebuilding approval and supplier logic."},{"title":"AI agent and automation builders","description":"Give assistants structured tool access for discovery, quoting, and approved operations through MCP-compatible endpoints."}]},{"heading":"Find your integration","items":[{"title":"API docs & OpenAPI","description":"Find the API reference for assistant tooling and design sessions, then choose the community, supplier or enterprise contract for your workflow. Human guide: Explore API docs (/en-us/developers/api-integrations). Machine-readable contract: Assistant tooling OpenAPI JSON (/api/docs/openapi.json). Access: public. Public reference for assistant and tooling APIs. Production access and order-affecting operations still require the applicable authorization. Canonical section: /en-us/developers#api-docs."},{"title":"Community API","description":"Connect a club or community website to public community information, design submissions, voting and order approval handoffs. Human guide: Explore the Community API (/en-us/developers/api-integrations#community-integrations). Machine-readable contract: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Public versioned contract for storefront embeds, community discovery, and locale-aware handoffs. Canonical section: /en-us/developers#community-integrations."},{"title":"Supplier API","description":"Connect approved supplier systems to released production packages, onboarding status and ERP or PLM webhook workflows. Human guide: Explore the Supplier API (/en-us/developers/api-integrations#supplier-integrations). Machine-readable contract: Supplier OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Public contract for planning and client generation. Operational supplier access remains permissioned. Canonical section: /en-us/developers#supplier-integrations."},{"title":"Enterprise Identity API","description":"Connect approved company workspaces to single sign-on, user and group provisioning, and identity audit records. Human guide: Explore enterprise identity (/en-us/developers/api-integrations#enterprise-integrations). Machine-readable contract: Enterprise identity OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Protected contract for approved enterprise workspaces; request access before using this endpoint. Canonical section: /en-us/developers#enterprise-integrations."},{"title":"AI agents & MCP","description":"Connect an AI assistant through the Model Context Protocol. Discover supported tools and preserve the user’s design choices, permissions and required confirmations. Human guide: Explore AI agents & MCP (/en-us/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/.well-known/mcp/server-card). Access: public. Public discovery document for machine clients. The external tools list at /api/v1/mcp/tools exposes current tool metadata; each tool call still follows its declared security, workspace, and confirmation boundaries. Canonical section: /en-us/developers#mcp-tools."}]},{"heading":"From first request to production","items":[{"title":"Step 1: Choose the contract that matches your workflow","description":"Start with the surface that matches your user and auth model: community embed, enterprise identity, supplier operations, or MCP tools for assistants."},{"title":"Step 2: Validate auth, versioning, and environment boundaries","description":"Confirm required headers, scopes, callback expectations, and contract versions in staging before you route production traffic."},{"title":"Step 3: Test end-to-end workflows before launch","description":"Verify requests, webhooks, provisioning, observability, and rollback paths so the integration is reliable from first live usage."}]},{"heading":"What production-ready means","paragraphs":["A production integration needs more than a public endpoint. Use these gates to decide whether your workflow is ready for customer, supplier, enterprise, or AI-agent traffic."],"items":[{"title":"Sandbox and access review","description":"Confirm which contracts are public, which enterprise surfaces require approval, and which credentials or workspace roles are needed before launch."},{"title":"Versioned implementation evidence","description":"Keep generated clients, callback URLs, auth scopes, contract versions, and rollback ownership documented before production traffic is enabled."},{"title":"Operational observability","description":"Plan logs, retries, support ownership, failure states, and health checks for every workflow that can affect an order, supplier, or enterprise user."}]},{"heading":"Before you start building","items":[{"title":"Which MerchandAise API should I use?","description":"Use the Community API for club and community website workflows, the Supplier API for approved supplier operations, and the Enterprise Identity API for company sign-in and provisioning. The API reference covers assistant tooling; the MCP guide explains how AI assistants discover and use supported tools."},{"title":"Can I read the API specifications without an account?","description":"The assistant tooling, Community and Supplier OpenAPI specifications are public. The Enterprise Identity specification is protected. Reading a public specification does not grant permission to execute protected requests or place orders."},{"title":"Do I need a developer integration to order a product?","description":"No. Individuals, clubs and companies can use the MerchandAise website to explore supported products and request a quote. APIs are an optional way to connect your own systems or experience."},{"title":"What should I include in an integration request?","description":"Describe who will use it, the systems involved, the information you need to read or update, and your intended timeline. Include sign-in, environment and callback requirements if known. The team reviews the appropriate contract and access model with you."}]},{"heading":"Planning a custom integration?","paragraphs":["Share the systems involved, the workflow you want to support, and your rollout timing. We will help you choose the right contract, access model, and launch sequence."],"items":[{"title":"Discuss an integration","description":"/en-us/contact/integrations"},{"title":"Explore enterprise","description":"/en-us/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}