Cowdidocs
API ReferenceWebhooks

Get an event

GET
/v1/webhooks/events/{eventId}

Reads one event raised for the caller's organization, with its payload. Requires the org:connect:read permission. Returns 404 when the caller's organization has no event with this id.

Authorization

oauth2
AuthorizationBearer <token>

Create a client with POST /v1/oauth/clients, then exchange its credentials for an access token. AUTHORIZATION_CODE clients act on behalf of a signed-in user and always use PKCE; CLIENT_CREDENTIALS clients act as themselves. A client may only be granted scopes its creator already holds — read the grantable list from GET /v1/oauth/clients/scopes.

In: header

Path Parameters

eventId*string

Unique identifier of the event.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/webhooks/events/0198c1c2-4f1e-7a3b-9c2d-6f0a1b2c3d4e"
{  "id": "0198c1c2-4f1e-7a3b-9c2d-6f0a1b2c3d4e",  "event_type": "approval.outcome",  "category": "APPROVAL",  "event_key": "approval.outcome:0198c1c2-4f1e-7a3b-9c2d-6f0a1b2c3d4e",  "payload_version": 1,  "data": {},  "created_at": "2026-09-01T10:15:30Z"}
{  "code": "BAD_REQUEST",  "description": "Bad Request"}
{  "code": "UNAUTHORISED",  "description": "Unauthorised"}
{  "code": "FORBIDDEN",  "description": "Forbidden"}
{  "code": "BAD_REQUEST",  "description": "Invalid input"}
{  "code": "RATE_LIMIT_EXCEEDED",  "description": "Too Many Requests"}
{  "code": "INTERNAL_ERROR",  "description": "Internal Server Error"}

List events GET

Lists every event this platform raised for the caller's organization, newest first, with the payload a receiver reads under `data`. An event appears here whether or not a webhook subscribed to it, so the feed is readable before the first webhook exists. Requires the `org:connect:read` permission. Narrow it with `type` and a `created_from`/`created_until` window. The list deliveries operation says what was sent; this one says what happened.

List subscribable event types GET

Lists the platform's public event vocabulary. Subscribe a webhook only to the event types listed here. Each entry carries its category, which is the resource the event happens to, so a picker can group the list. Requires the `org:connect:read` permission.