Webhooks

List Webhooks

Retrieves webhooks for the authenticated team (paginated). Results are capped at limit (default and maximum 1000). When more records exist than are returned, meta.total exceeds data.length; clients with large collections must page with limit/offset to retrieve them all.

get/api/v2/webhooks

Query parameters

limitinteger

Maximum number of webhooks to return.

offsetinteger

Number of webhooks to skip before returning results.

Response

Successfully retrieved webhooks

Example response

{
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Production Alerts",
      "service": "slack",
      "url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX",
      "description": "Sends critical alerts to the #incidents channel",
      "updatedAt": "2025-06-15T10:30:00.000Z",
      "createdAt": "2025-01-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "total": 142,
    "limit": 50,
    "offset": 100
  }
}

Changes

Changed in 4 of the 60 revisions of this API.114

    • added the new optional query request parameter limit

      new-optional-request-parameter

    • added the new optional query request parameter offset

      new-optional-request-parameter

    • added the required property meta to the response with the 200 status

      response-required-property-added

    • removed the optional property data/items/oneOf[GenericWebhook]/headers from the response with the 200 status

      response-optional-property-removed

    • endpoint added

      endpoint-added

    • api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 100 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog