Getting started

Module

Webhook events

Audit of events received from providers, keeping the native payload intact.

GET/webhook-events
GET/webhook-eventsScope: readOfficial + Basic

List received events.

Returns the raw events (messages, statuses, QR) received from connections for auditing and external reprocessing.

Path parameters

No additional parameters.

Query parameters
FieldTypeDescription
connection_idoptionaluuidFilters by connection.
sourceoptionalmeta | freemiumFilters by source: Official connection (meta) or Basic plan connection (freemium).
eventoptionalstringFilters by event name (e.g. messages).
limitoptionalnumberRecords per page. Default 50; maximum 200 on most list endpoints.
offsetoptionalnumberInitial page index. Use pagination.next_offset to fetch the next page.

Body fields

This endpoint does not receive a JSON body.

Ready examples

curl -X GET "https://connect.zyronstack.com/api/v1/webhook-events?source=meta&limit=20&offset=0" \
  -H "Authorization: Bearer SUA_CHAVE_API"

Responses

200Events returned.

Response example

{
  "data": [
    {
      "id": 30,
      "source": "meta",
      "event": "messages",
      "connection_id": "<CONNECTION_ID>",
      "payload": { "messages": [{ "from": "5511999998888", "type": "text" }] },
      "created_at": "2026-07-13T13:28:27.898Z"
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "total": 2, "next_offset": null }
}