API ReferenceWebhooks
Get Webhook Logs
Retrieve delivery logs for a webhook configuration.
GET /api/webhooks/{id}/logs
Returns the most recent delivery log entries (up to 100) for the specified webhook configuration. Each log entry records a single delivery attempt including the event payload, delivery status, and number of attempts.
Authentication
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer token. Format: Bearer <token> |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The unique identifier of the webhook configuration. |
Response
[
{
"id": "log-f1e2d3c4-b5a6-9870-fedc-ba0987654321",
"eventType": "message",
"payload": {
"event": "message",
"session": "u_a80ffc98_s_c1a2b3c4",
"payload": {
"id": "true_1234567890@c.us_3EB0A0B1C2D3E4F5",
"from": "1234567890@c.us",
"body": "Hello!",
"timestamp": 1710410700
}
},
"status": "delivered",
"attempts": 1,
"deliveredAt": "2026-03-14T10:05:01.000Z",
"createdAt": "2026-03-14T10:05:00.000Z"
},
{
"id": "log-a2b3c4d5-e6f7-8901-abcd-ef2345678901",
"eventType": "message.ack",
"payload": {
"event": "message.ack",
"session": "u_a80ffc98_s_c1a2b3c4",
"payload": {
"id": "true_1234567890@c.us_3EB0A0B1C2D3E4F5",
"ack": 3
}
},
"status": "failed",
"attempts": 5,
"deliveredAt": null,
"createdAt": "2026-03-14T10:06:00.000Z"
}
]{
"statusCode": 401,
"message": "Unauthorized"
}{
"statusCode": 404,
"message": "Webhook not found"
}