List webhook endpoints

​

Returns registered webhook endpoints:

  • From oldest to newest by creation time, then ID.
  • With an empty items array when none are registered.
  • Without signing secrets. A secret is returned only by the original registration response or its exact idempotent replay.

Removed endpoints are not returned.

OAuth scopes
  • webhooks:write

Query Parameters

  • cursor
    Type: string
    min length:  
    1
    max length:  
    1000

    Unchanged nextCursor value used to retrieve the next page. It is valid for 24 hours and only with the Partner, endpoint and filters that produced it. See Pagination.

  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Number of records to return, from 1 to 100. Defaults to 50. See Pagination.

Headers

  • X-Request-Id
    Type: stringFormat: uuid

    Client-generated UUID for tracing. This does not make retries safe.

Responses

  • application/json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
get/webhook-endpoints
Registered webhook endpoints
{
  "items": [
    {
      "id": "webhook_7e2a91c4",
      "url": "https://api.northstarworkforce.invalid/webhooks/payrollkit",
      "eventTypes": [
        "resource.changed"
      ],
      "status": "active",
      "createdAt": "2026-08-20T11:00:00Z"
    }
  ],
  "nextCursor": null
}

Webhook endpoint page