# List webhooks

Gets the list of all webhooks that the user owns (if a user-generated
token was used to make the request) or the list of all webhooks associated
with the third-party app (if a third-party app made the request). Items in
the response are ordered by API cient name > webhook name > creation date.

Note: In the response, each webhook's events field defaults to "."], regardless of its actual value. Alternatively, call [GET /webhook/{webhookId} on an individual webhook to get its events value. 

DEPRECATION - As early as the sunset date specified in this Changelog entry, webhooks will be sorted by creation date (most recent first) instead of name. See the Changelog entry for migration instructions and details.

Endpoint: GET /webhooks
Version: 2.0.0
Security: APIToken, OAuth2

## Header parameters:

  - `Authorization` (string)
    API Access Token used to authenticate requests to Smartsheet APIs.

  - `smartsheet-integration-source` (string)
    Uses the following metadata to distinguish between human-initiated API requests and third-party service-initiated calls by AI Connectors or ITSM:

- Integration source type
- Organization name
- Integration source name 

Format:


TYPE,OrgName,SourceName


Examples: 

AI,SampleOrg,My-AI-Connector-v2

SCRIPT,SampleOrg2,Accounting-updater-script

APPLICATION,SampleOrg3,SheetUpdater
    Example: "AI,SampleOrg,My-AI-Connector-v2"

## Query parameters:

  - `page` (number)
    Which page to return. Defaults to 1 if not specified. If you specify a value greater than the total number of pages, the last page of results is returned.

  - `includeAll` (boolean)
    If true, include all results, that is, do not paginate. Mutually exclusive
with page and pageSize (they are ignored if includeAll=true is specified).

DEPRECATED - As early as the sunset date specified in this Changelog entry, this parameter will be discontinued (sunset) to reduce latency, mitigate performance issues, and add stability, especially for users with many webhooks. See the Changelog entry for migration instructions and details.

  - `pageSize` (number)
    The maximum number of items to return per page. Unless otherwise stated for a
specific endpoint, defaults to 100. If only page is specified, defaults to a
page size of 100. For reports, the default is 100 rows. If you need larger
sets of data from your report, returns a maximum of 10,000 rows per request.

DEPRECATED - As early as the sunset date specified in this Changelog entry, the unlimited value range will be discontinued (sunset) to reduce latency, mitigate performance issues, and add stability, especially for users with many webhooks. See the Changelog entry for migration instructions and details.

## Response 200 fields (application/json):

  - `pageNumber` (number)
    The current page in the full result set that the data array represents.
NOTE when a page number greater than totalPages is requested, the last
page is instead returned.
    Example: 1

  - `pageSize` (number,null)
    The number of items in a page. Omitted if there is no limit to page size (and hence, all results are included). Unless otherwise specified, this defaults to 100 for most endpoints.
    Example: 50

  - `data` (array)
    list of Webhooks

  - `totalPages` (number)
    The total number of pages in the full result set.

DEPRECATED - As early as the sunset date specified in this [Changelog entry](/api/smartsheet/changelog#2025-08-04), this response property value will be -1. See the [Changelog entry](/api/smartsheet/changelog#2025-08-04) for migration instructions and details.
    Example: 25

  - `totalCount` (number)
    The total number of items in the full result set.

DEPRECATED - As early as the sunset date specified in this [Changelog entry](/api/smartsheet/changelog#2025-08-04), this response property value will be -1. See the [Changelog entry](/api/smartsheet/changelog#2025-08-04) for migration instructions and details.
    Example: 136

## Response default fields (application/json):

  - `refId` (string)
    The ID of the specific error occurrence. Please include this information when contacting Smartsheet support.

  - `errorCode` (number)
    Custom error code from Smartsheet. See the complete [Error Code List](/api/smartsheet/error-codes).

  - `message` (string)
    Descriptive error message.