GET /v1/analytics/webhook-logs — view delivery logs

The Webhook Logs endpoint returns a paginated list of delivery attempt records for your registered webhooks. Each log entry captures the event type delivered, the HTTP status code your server returned, response time, and any error message from failed attempts. Use webhookId and status filters to narrow results when debugging a specific endpoint or triaging a batch of failures.

This endpoint requires the analytics:read permission on your API key.

Request

GET https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/analytics/webhook-logs

Headers

string

required

Bearer token using your API key. Format: Bearer cs_live_your_key

Query parameters

integer

default:"50"

Number of log entries to return per page. Maximum 100.

string

Pagination cursor returned by the previous response. Pass this value to retrieve the next page of results.

string

Filter results to delivery attempts for a specific webhook endpoint.

string

Filter results by delivery status. Accepted values: SUCCESS, FAILED, PENDING.

Response

200 — success

array

List of webhook delivery log entries.

Show WebhookLog object properties

string

Unique identifier for this log entry.

string

The identifier of the webhook that attempted this delivery.

string

The event type that was delivered (e.g., donation.created).

string

Delivery outcome: SUCCESS, FAILED, or PENDING.

integer

HTTP response code returned by your endpoint. null if the request never reached your server (e.g., DNS failure or timeout).

integer

Time in milliseconds from delivery attempt to response (or failure).

integer

Unix timestamp (seconds) of the delivery attempt.

string

Description of the error if the delivery failed. null on successful deliveries.

integer

Number of log entries returned in this page.

boolean

true if additional pages of results are available.

string

Pagination cursor to pass as lastEvaluatedKey in your next request. null when you have reached the last page.

401 — unauthorized

Returned when your API key is missing, invalid, or lacks the analytics:read permission.

Example

curl "https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/analytics/webhook-logs?status=FAILED&limit=25" \
  -H "Authorization: Bearer cs_live_your_key"

curl "https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/analytics/webhook-logs?webhookId=wh_01hx4kz9mntd8vr2bpqe5ycf3a" \
  -H "Authorization: Bearer cs_live_your_key"

Sample response (200)

{
  "logs": [
    {
      "logId": "log_03kz6mc1pqvf0xt4drsg7aeh5c",
      "webhookId": "wh_01hx4kz9mntd8vr2bpqe5ycf3a",
      "eventType": "donation.created",
      "status": "FAILED",
      "httpStatus": 500,
      "responseTime": 1243,
      "timestamp": 1714089900,
      "errorMessage": "Server returned 500 Internal Server Error"
    },
    {
      "logId": "log_04la7nd2qrwg1yu5estg8bfi6d",
      "webhookId": "wh_01hx4kz9mntd8vr2bpqe5ycf3a",
      "eventType": "subscription.cancelled",
      "status": "FAILED",
      "httpStatus": null,
      "responseTime": 30001,
      "timestamp": 1714089600,
      "errorMessage": "Request timed out after 30 seconds"
    }
  ],
  "count": 2,
  "hasMore": false,
  "lastEvaluatedKey": null
}

A delivery with httpStatus: null means your server was unreachable — check DNS, firewall rules, and TLS certificate validity for the webhook URL. CharityStack considers any non-2xx response code a failure.

Organization

Payments

Subscriptions

Contacts

Forms

Prefilled-Checkout Links

Webhooks

Analytics

GET /v1/analytics/webhook-logs — view delivery logs

Request

Headers

Query parameters

Response

200 — success

401 — unauthorized

Example

​Request

​Headers

​Query parameters

​Response

​200 — success

​401 — unauthorized

​Example

Request

Headers

Query parameters

Response

200 — success

401 — unauthorized

Example