Wayfair website screenshot

Wayfair

Wayfair Inc. is one of the world's largest online destinations for home goods and furniture, serving over 20 million customers and 10,000+ suppliers. Wayfair's Developer Portal provides GraphQL-based APIs enabling suppliers to manage purchase orders, inventory updates, product catalog management, advanced shipment notifications, and returns. The platform is built on federated GraphQL architecture using domain-oriented microservices, allowing suppliers to request only the data they need.

1 APIs 7 Features
E-CommerceFurnitureHome GoodsRetailSuppliersGraphQL

APIs

Wayfair Supplier API

GraphQL-based API for Wayfair suppliers to manage orders, inventory, product catalogs, shipping notifications, and returns. Provides access to purchase orders, inventory updates...

Collections

Wayfair Supplier API

OPEN

GraphQL

Wayfair GraphQL API

GraphQL-based API for Wayfair suppliers to manage orders, inventory, product catalogs, shipping notifications, and returns. Provides access to purchase orders, inventory updates...

GRAPHQL

Pricing Plans

Wayfair Plans Pricing

3 plans

PLANS

Rate Limits

Wayfair Rate Limits

5 limits

RATE LIMITS

FinOps

Wayfair Finops

FINOPS

Features

GraphQL Supplier API

Unified GraphQL endpoint enabling suppliers to query and mutate data across orders, inventory, catalog, and shipping with precise data fetching.

Purchase Order Management

Suppliers retrieve, acknowledge, and manage purchase orders from Wayfair buyers through the GraphQL API.

Inventory Management

Real-time inventory updates and stock level management for the Wayfair marketplace catalog.

Product Catalog Management

Suppliers manage product listings, pricing, descriptions, and attributes through the Product Catalog Update API.

Advanced Shipment Notifications

Suppliers submit ASN (Advanced Shipment Notification) data to notify Wayfair of pending shipments, carrier details, and tracking numbers.

Sandbox Testing Environment

Full sandbox environment at sandbox.api.wayfair.com/v1/graphql for integration testing without affecting production orders.

OAuth2 Token Authentication

Client credentials flow authentication issuing temporary access tokens for secure API access.

Use Cases

Order Fulfillment Automation

Suppliers automate purchase order retrieval, acknowledgment, and fulfillment workflows to reduce manual processing time.

Inventory Synchronization

Real-time synchronization of warehouse inventory levels with the Wayfair marketplace to prevent overselling.

Product Catalog Updates

Batch and real-time updates to product listings, pricing, and attributes in the Wayfair catalog.

Shipping Notification Automation

Automated submission of ASN data and tracking information when orders are shipped from supplier warehouses.

Integrations

Wayfair Sandbox

Full sandbox environment for integration testing before deploying to the production Wayfair platform.

Apollo GraphQL Federation

Wayfair's federated GraphQL architecture enables domain-oriented microservices composition behind a unified supplier API.

OAuth2 Authentication

Standard OAuth2 client credentials flow for secure supplier application authentication.

Semantic Vocabularies

Wayfair Context

5 classes · 15 properties

JSON-LD

API Governance Rules

Wayfair API Rules

31 rules · 14 errors 16 warnings 1 info

SPECTRAL

JSON Structure

Wayfair Graph Ql Error Structure

3 properties

JSON STRUCTURE

Wayfair Graph Ql Request Structure

3 properties

JSON STRUCTURE

Wayfair Graph Ql Response Structure

2 properties

JSON STRUCTURE

Wayfair Token Request Structure

2 properties

JSON STRUCTURE

Wayfair Token Response Structure

3 properties

JSON STRUCTURE

Example Payloads

Wayfair Graph Ql Error Example

3 fields

EXAMPLE

Wayfair Graph Ql Request Example

3 fields

EXAMPLE

Wayfair Graph Ql Response Example

2 fields

EXAMPLE

Wayfair Token Request Example

2 fields

EXAMPLE

Wayfair Token Response Example

3 fields

EXAMPLE

Resources

🔗
LinkedIn
LinkedIn
🌐
Developer Portal
Portal
🌐
Developer Portal (Introduction)
Portal
🔗
GraphQL Documentation
Documentation
🔗
Sandbox API Testing
Documentation
🔗
Wayfair Website
Website
🔗
About Wayfair
About
👥
Wayfair GitHub Organization
GitHubOrganization
🔗
Wayfair Spectral Rules
SpectralRules
🔗
Wayfair Vocabulary
Vocabulary
🔗
Wayfair JSON-LD Context
JSONLD

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Wayfair Supplier API
  version: 1.0.0
items:
- info:
    name: Authentication
    type: folder
  items:
  - info:
      name: Wayfair Get Access Token
      type: http
    http:
      method: POST
      url: https://api.wayfair.com/v1/auth/token
      body:
        type: json
        data: '{}'
    docs: Obtain a temporary OAuth2 access token using your application client ID and secret. Tokens are used to authenticate
      subsequent API requests. Tokens expire and must be refreshed periodically.
- info:
    name: GraphQL
    type: folder
  items:
  - info:
      name: Wayfair Execute GraphQL Query
      type: http
    http:
      method: POST
      url: https://api.wayfair.com/v1/graphql
      body:
        type: json
        data: '{}'
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Execute a GraphQL query or mutation against the Wayfair Supplier API. Supports operations for order management,
      inventory updates, product catalog management, and shipping notifications. The GraphQL schema enables suppliers to precisely
      request only the fields needed for their integration workflows.
bundled: true