Webhook Events

Poll recent webhook events

curl "https://api.subscriby.net/v1/webhook-events?type=subscription.created&limit=3" \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

The most recent deliveries of one event type, newest first, as the envelopes the endpoints received. limit defaults to 3 and is capped at 10; project_id restricts to deliveries whose endpoint is scoped to that project.

api_version is the payload-envelope stamp the dispatcher wrote at delivery time; see versioning. Results are ordered by created_at descending. Only deliveries against endpoints owned by the token's team are returned; other tenants' events are never surfaced.

data is empty when no endpoint in your team is subscribed to the requested event type yet, or when no delivery has fired for that type since the relevant endpoint was created. Zapier, Make, and n8n all fall back to the trigger's static sample in that case, so builders can still author a Zap end-to-end before the first live event flows.

get/v1/webhook-events

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/webhook-events
  • Auth: HTTP bearer

Query parameters

typestring required

The event name to sample, such as subscription.created; must be a case from the outbound webhook event catalog. An unknown name is refused.

limitinteger

How many recent deliveries to return, 1 to 10.

project_idstring uuid

Restrict to deliveries whose endpoint is confined to this project.

Response

Array of WebhookEventResource

Example response

{
  "data": [
    {
      "id": "evt_01HXZ3Q8M7Y2K4N6P9R1T3V5W7",
      "type": "subscription.created",
      "created_at": "2026-05-18T10:05:00Z",
      "api_version": "2026-05-01",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.