GET/v1/webhooks/eventsbeta

List events

Needs: Read your data (mcp:read)
Plan: Any plan with API access
Limits: 300 a minute per key
Undo: Nothing to undo: this only reads.

Lists the events that happened in your workspace, newest first. Events are kept for 30 days.

Try it

Query (6)

event_type_idoptionalstring

Only this type, e.g. `contact.created/1`.

endpoint_idoptionalstring

Only events sent to this endpoint.

fromoptionalstring

Start of the window (ISO 8601 with offset). Default: 7 days ago. Kept 30 days.

tooptionalstring

End of the window. Default: now.

cursoroptionalstring

The `next_cursor` from the previous page. Cursors expire after 24 hours.

limitoptionalinteger

How many items per page (1–100).

This only reads. It uses your real data and changes nothing.

curl -X GET 'https://mcp.wa-api.cloud/v1/webhooks/events?event_type_id=contact.created%2F1' \
  -H "Authorization: Bearer $API_KEY"

The code reads your key from $API_KEY.

Parameters

Parameters
Field	Type	What it is
event_type_id	string · query	Only this type, e.g. `contact.created/1`.pattern `^[a-z0-9._-]+\/[A-Za-z0-9._-]+$`Signed in? Pick one from your data with “My data”.
endpoint_id	string · query	Only events sent to this endpoint.pattern `^ep_[0-9A-HJKMNP-TV-Z]{26}$`Signed in? Pick one from your data with “My data”.
from	string · query	Start of the window (ISO 8601 with offset). Default: 7 days ago. Kept 30 days.date-time · pattern `^(?:(?:\d\d[2468][048]\|\d\d[13579][26]\|\d\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\d\|30)\|(?:02)-(?:0[1-9]\|1\d\|2[0-8])))T(?:(?:[01]\d\|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z\|([+-](?:[01]\d\|2[0-3]):[0-5]\d)))$`
to	string · query	End of the window. Default: now.date-time · pattern `^(?:(?:\d\d[2468][048]\|\d\d[13579][26]\|\d\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\d\|30)\|(?:02)-(?:0[1-9]\|1\d\|2[0-8])))T(?:(?:[01]\d\|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z\|([+-](?:[01]\d\|2[0-3]):[0-5]\d)))$`
cursor	string · query	The `next_cursor` from the previous page. Cursors expire after 24 hours.1–2048 characters
limit	integer · query	How many items per page (1–100).1–100 · default `25`

Headers

Headers
Field	Type	What it is
Authorizationrequired	header	`Bearer $API_KEY` — your API key.
Api-Version	header	The API version to use, e.g. `2026-10-01`. Default: the version your key is pinned to.one of: `2026-10-01` · pattern `^\d{4}-\d{2}-\d{2}$`

Response `200`

A page of events.

Response fields
Field	Type	What it is
datarequired	array of object
idrequired	string
event_type_idrequired	string
event_type_namerequired	string
occurred_atrequired	string or null
created_atrequired	string or null
next_cursorrequired	string or null	Pass as "cursor" to get the next page; null when there are no more results.

Errors

Errors are application/problem+json. Branch on code.

Status	Code	When
400	invalid_input	A field is missing or has the wrong format. `errors[]` points at each field.
401	unauthenticated	The Authorization header is missing, the key is unknown, expired or revoked.
403	entitlement_required	The workspace's plan does not include API access (`api_access`).
403	insufficient_scope	The key does not have the permission this operation needs.
429	rate_limited	The key or workspace went over its rate limit. Wait for `Retry-After` seconds.
503	upstream_unavailable	A service behind the API is briefly unavailable. Safe to retry with backoff.

Examples

New contacts

Response 200

{
  "data": [
    {
      "id": "evt_01J8Z7BZQ4F6G8J2K5N7Q9S1VC",
      "event_type_id": "contact.created/1",
      "event_type_name": "contact.created",
      "occurred_at": "2026-09-23T03:02:10Z",
      "created_at": "2026-09-23T03:02:10Z"
    }
  ],
  "next_cursor": null
}

Operation path

The same operation is also at POST /v1/ops/webhooks_list_events, with every field in the JSON body.