v41

latestOpenAPI 3.0.0UNLICENSEDraw.githubusercontent.com2026-07-0839165177.6 KB

Events

Trigger event

Trigger a webhook event for a product on demand, in the shape your registered destinations would normally receive. Use during integration testing to exercise your handlers without waiting for an upstream update.

The event is targeted at the calling developer only. Pass an Idempotency-Key header so retried calls produce the same event ID and the delivery layer dedups.

post/api/v1/events/trigger

Request body

productUrlstring required

Product URL (e.g. https://flybyjing.com/products/sichuan-chili-crisp).

topic'product.updated' required

The webhook event topic to trigger.

Response

Created

idstring required

Unique identifier for the event. This can be used as an idempotency key to avoid double-processing of the same underlying event.

object'event' required

createdAtstring required

Timestamp of when the event was created.

dataEventData

The event data payload. The concrete shape depends on source.type.

Refer to webhook event types for the payload shape associated with each source.type.

Example response

{
  "id": "evt_1234567890",
  "createdAt": "2026-03-25T00:00:00Z",
  "source": {
    "id": "ci_1234567890"
  }
}