---
title: "List webhook deliveries"
method: GET
path: "/v1/webhook-deliveries"
tags: ["Webhooks"]
---

# List webhook deliveries

`GET /v1/webhook-deliveries`

## Request

- Base URL: `https://api.postzen.dev`
- URL: `https://api.postzen.dev/v1/webhook-deliveries`
- Auth: HTTP bearer

Returns retained delivery logs visible to the API key, newest first. Results are capped to the 1000 most recent matching deliveries.

## Query parameters

- `webhookId` string
- `event` 'post.scheduled' | 'post.published' | 'post.partially_failed' | 'post.failed' | 'post.cancelled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'account.connected' | 'account.needs_reauth' | 'account.disconnected' | 'analytics.synced' | 'conversation.started' | 'message.received' | 'message.sent' | 'comment.received' | 'contact.tag_added' | 'contact.tag_removed' | 'contact.field_changed' | 'webhook.test': Webhook event type. See the Webhook Events section for each event's trigger and payload. Receivers should tolerate additional event types in future API versions.
- `status` 'pending' | 'retrying' | 'delivered' | 'failed'
- `dateFrom` string, date-time
- `dateTo` string, date-time
- `page` integer
- `limit` integer

## Response `200`

Webhook deliveries returned.

- WebhookDeliveriesListResponse
  - `deliveries` WebhookDelivery[], required
    - `event` 'post.scheduled' | 'post.published' | 'post.partially_failed' | 'post.failed' | 'post.cancelled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'account.connected' | 'account.needs_reauth' | 'account.disconnected' | 'analytics.synced' | 'conversation.started' | 'message.received' | 'message.sent' | 'comment.received' | 'contact.tag_added' | 'contact.tag_removed' | 'contact.field_changed' | 'webhook.test', required: Webhook event type. See the Webhook Events section for each event's trigger and payload. Receivers should tolerate additional event types in future API versions.
    - `eventId` string, required: Stable across automatic retries and manual redeliveries.
    - `deliveryId` string, required
    - `resourceId` string, required
    - `status` 'pending' | 'retrying' | 'delivered' | 'failed', required
    - `attemptCount` integer, required: Monotonic count across automatic retries and manual redeliveries.
    - `lastHttpStatus` integer
    - `lastErrorCode` string
    - `lastDurationMs` number
    - `createdAt` string, date-time, required
    - `lastAttemptAt` string, date-time
    - `deliveredAt` string, date-time
    - `nextAttemptAt` string, date-time
  - `pagination` Pagination, required
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `totalPages` integer, required

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid API key.
- `403`: The API key does not have sufficient permission or profile access.
- `404`: Resource not found.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/postzen/apis/postzen-public-api.md) · [All operations](https://skmtc.dev/postzen/apis/postzen-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postzen/apis/postzen-public-api/revisions/40863e3710ec?raw)