Building a webhook integration? Read the webhook guide for signatures, retries, event schemas, and troubleshooting.

apiDeterministic

List webhook deliveries

GET /api/v1/webhook-endpoints/{endpointId}/deliveries

List a cursor-paginated delivery history for an endpoint, with optional event, status, and date filters. Includes attempt history, response status, duration, and safe error details.

Parameters

workspaceId

string

Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.

endpointIdrequired

string

No description.

limit

integer

No description.

cursor

string

No description.

eventType

string

No description.

status

string

No description.

pending | processing | delivered | exhausted | canceled

createdFrom

string

No description.

createdTo

string

No description.

Example

REST requestbash

curl -X GET "https://app.pipeline.help/api/v1/webhook-endpoints/00000000-0000-4000-8000-000000000000/deliveries" \
  -H "Authorization: Bearer $PIPELINE_API_KEY"

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "deliveries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "eventId": {
            "type": "string",
            "format": "uuid"
          },
          "eventType": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "attemptCount": {
            "type": "number"
          },
          "nextAttemptAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "lastStatusCode": {
            "type": [
              "number",
              "null"
            ]
          },
          "lastDurationMs": {
            "type": [
              "number",
              "null"
            ]
          },
          "lastErrorCode": {
            "type": [
              "string",
              "null"
            ]
          },
          "lastError": {
            "type": [
              "string",
              "null"
            ]
          },
          "attemptHistory": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "payload": {
            "type": [
              "object",
              "null"
            ]
          },
          "deliveredAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "eventId",
          "eventType",
          "status",
          "attemptCount",
          "nextAttemptAt",
          "lastStatusCode",
          "lastDurationMs",
          "lastErrorCode",
          "lastError",
          "attemptHistory",
          "payload",
          "deliveredAt",
          "createdAt"
        ]
      }
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "deliveries",
    "nextCursor"
  ]
}

HTTP errors

401: Missing or invalid API key.
403: Authenticated but not permitted for the workspace or resource.
404: The requested resource was not found.