Webhooks

List registered webhooks

Returns the tenant's webhooks as a paginated list. Each item carries its source, events, and config. The plaintext secret is never present on list items.

get/v1/webhooks

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/webhooks
  • Auth: HTTP bearer

Query parameters

cursorstring

Pagination cursor from a previous response; decodable, pass it back verbatim

limitinteger

Max items per page (1-250, default 50)

Response

A page of registered webhooks. The plaintext secret is never present on list items.

object'webhook_list'

Response type discriminator.

cursorstring nullable

Opaque next-page cursor. Null on the last page.

Example response

{
  "items": [
    {
      "last_delivery_at": "2026-06-17T10:05:00Z",
      "delivery_success_rate_7d": 98
    }
  ],
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.