WHwhatnot
Products

Create a product

Create a product in the seller's catalog. Whatnot creates one variant for every combination of the product's option values, or a single variant when it has no options. Variants start without a price or inventory, so the product is not on sale until you price them, set their inventory, and merchandise the product.

post/products

Request

  • Base URL
    https://api.whatnot.com/seller-api/rest/v2
  • URL
    https://api.whatnot.com/seller-api/rest/v2/products
  • Auth
    OAuth 2
    Authorization code: https://api.whatnot.com/seller-api/rest/oauth/authorize
    Token URL: https://api.whatnot.com/seller-api/rest/oauth/token

Request body

titlestring required

The product's title.

descriptionstring nullable

The product's description.

external_idstring nullable

The seller-provided external identifier for the product.

Example request

{
  "attributes": [
    {
      "id": "7",
      "value": "Near Mint"
    }
  ],
  "category": {
    "id": "42"
  },
  "description": "A very rare card.",
  "dimension_profile": {
    "dimensions": {
      "height": 1,
      "length": 6,
      "unit": "inch",
      "width": 4
    },
    "weight": {
      "unit": "ounce",
      "value": 4
    }
  },
  "external_id": "uuid-123",
  "media": [
    {
      "alt": "front",
      "url": "https://images.whatnot.com/example.jpg"
    }
  ],
  "options": [
    {
      "name": "Color",
      "values": [
        "Red",
        "Blue"
      ]
    }
  ],
  "title": "Rare Holographic Card"
}

Response

The product was created.

idstring nullable

The product's id.

titlestring required

The product's title.

descriptionstring nullable

The product's description.

external_idstring nullable

The seller-provided external identifier for the product.

urlstring nullable

The url of the product in the seller's inventory dashboard.

created_atstring date-time nullable

When the product was created.

updated_atstring date-time nullable

When the product was last updated.

Example response

{
  "attributes": [
    {
      "id": "7",
      "name": "Condition",
      "value": "Near Mint"
    }
  ],
  "category": {
    "id": "42",
    "name": "Trading Cards"
  },
  "created_at": "2026-01-15T12:00:00.000Z",
  "description": "A very rare card.",
  "dimension_profile": {
    "active": true,
    "dimensions": {
      "height": 1,
      "length": 6,
      "unit": "inch",
      "width": 4
    },
    "id": "88",
    "name": "API 4 oz",
    "ownership": "seller",
    "weight": {
      "unit": "ounce",
      "value": 4
    }
  },
  "external_id": "ext-123",
  "id": "12345",
  "media": [
    {
      "alt": "front",
      "id": "555",
      "url": "https://cdn.whatnot.com/i/555.jpg"
    }
  ],
  "options": [
    {
      "id": "1001",
      "name": "Color",
      "values": [
        "Red",
        "Blue"
      ]
    }
  ],
  "title": "Rare Holographic Card",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "url": "https://www.whatnot.com/product/abc123"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.