---
title: "Get webhook events"
method: GET
path: "/open-api/v1.0/webhook-events"
tags: ["Webhooks"]
---

# Get webhook events

`GET /open-api/v1.0/webhook-events`

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Get webhook events with pagination and optional filtering by one or more webhook types (repeat or comma-separate the `type` param).

## Query parameters

- `type` string[]
- `page` integer
- `size` integer

## Response `200`

OK

- ComFourthwallOpenapiModelOpenApiPageResponseComFourthwallOpenapiModelWebhookEventV1
  - `results` ComFourthwallOpenapiModelWebhookEventV1[], required
    - `id` string, required — Event ID
    - `type` 'ORDER_PLACED' | 'ORDER_UPDATED' | 'GIFT_PURCHASE' | 'PRODUCT_CREATED' | 'PRODUCT_UPDATED' | 'DONATION' | 'SUBSCRIPTION_PURCHASED' | 'SUBSCRIPTION_EXPIRED' | 'SUBSCRIPTION_CHANGED' | 'NEWSLETTER_SUBSCRIBED' | 'THANK_YOU_SENT' | 'GIFT_DRAW_STARTED' | 'GIFT_DRAW_ENDED' | 'PROMOTION_CREATED' | 'PROMOTION_UPDATED' | 'PROMOTION_STATUS_CHANGED' | 'PLATFORM_APP_DISCONNECTED' | 'MEMBERSHIP_POST_UPSERTED' | 'MEMBERSHIP_SERIES_UPSERTED' | 'MEMBERSHIP_SERIES_DELETED' | 'MEMBERSHIP_TAG_CREATED' | 'MEMBERSHIP_TAG_UPDATED' | 'MEMBERSHIP_TAG_DELETED' | 'MEMBERSHIP_TIER_UPSERTED' | 'MEMBERSHIP_TIER_DELETED' | 'COLLECTION_UPDATED' | 'CART_ABANDONED_1H' | 'CART_ABANDONED_24H' | 'CART_ABANDONED_72H', required — Event type
    - `apiVersion` 'V1', required — API version
    - `createdAt` string, date-time, required — When the event was created
    - `updatedAt` string, date-time, required — When the event was last updated
    - `body` string, required — Event body as JSON string
    - `testMode` boolean, required — Whether this is a test mode event
    - `state` string, required — Event state
    - `error` string — Error message if delivery failed
    - `url` string, required — URL
  - `total` integer
  - `page` integer
  - `size` integer
  - `totalPages` integer

## Other responses

- `429` — Rate limited: 100 requests / 10 seconds per shop.

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-2.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-2/revisions/ef273312f051/schema)