Webhook

shows.updated

A show changed, such as its title, start time or visibility. Every update is sent, even one that only changed updated_at. Requires read:shows.

Headers

webhook-id
Type: stringFormat: uuid
required

Unique ID of the event. Retries of a delivery send the same ID, so use it to deduplicate.
webhook-timestamp
Type: integerFormat: int64
required

When this delivery attempt was sent, as a Unix timestamp in seconds. Each retry sends a new timestamp.
webhook-signature
Type: string
required

Space-separated signatures, each v1, followed by the base64 HMAC-SHA256 of {webhook-id}.{webhook-timestamp}.{body}, keyed with your webhook secret.

Body·ShowUpdatedWebhookBody

required

application/json

data
Type: Show
required

The event's data. Its shape depends on the topic.

Properties: 10
seller_id
Type: string
required

The ID of the seller the event belongs to.
timestamp
Type: stringFormat: date-time
required

When the event happened, in ISO 8601. Stable across retries; the webhook-timestamp header is when each attempt was sent.
type
const:
shows.updated
required

The webhook topic.
version
const:
v2
required

The payload version.

Responses

200

Acknowledge delivery. Any 2XX status counts.
default

Fail delivery. Non-2XX statuses and timeouts are retried.

postshows.updated

{
  "type": "shows.updated",
  "timestamp": "2026-10-20T16:00:00.123Z",
  "data": {
    "created_at": "2026-09-20T18:30:00.000Z",
    "description": "Vintage and modern breaks, giveaways every 30 minutes.",
    "id": "0b6f3c1e-8a52-4d2e-9f7a-3c5d1e2f4a6b",
    "scheduled_start_at": "2026-09-27T01:00:00.000Z",
    "status": "scheduled",
    "thumbnail": {
      "id": "12345",
      "url": "https://images.whatnot.com/thumbnail.jpg"
    },
    "title": "Sunday Night Pokémon Breaks",
    "updated_at": "2026-09-21T09:15:00.000Z",
    "visibility": "public"
  },
  "version": "v2",
  "seller_id": "1234567"
}

No Body

Acknowledge delivery. Any 2XX status counts.

shows.created

shows.started