---
title: "Get webhooks"
method: GET
path: "/settings/v1/webhooks"
tags: ["Settings:v1:Webhook"]
---

# Get webhooks

`GET /settings/v1/webhooks`

Retrieves a list of webhook settings associated with the account.

## Query parameters

- `featureType` string, nullable — The feature type of the webhook. Current options are: users, forms, time_activity, tasks
- `limit` integer — The maximum number of results to display per page
- `offset` integer — The resource offset of the last successfully read resource will be returned as the paging.offset JSON property of a paginated response containing more results

## Response `200`

Successful Response

- PaginatedBaseResponseV2WebhookListResponse
  - `requestId` string
  - `data` WebhookListResponse, required
    - `webhooks` WebhookResponse[], required — List of webhooks
      - `id` integer, required — The unique identifier of the webhook
      - `name` string, required — The name of the webhook
      - `userId` integer, required — Webhook creator's user id
      - `timeCreated` integer, required — The timestamp when the webhook was created
      - `url` string, uri, required — The webhook's URL
      - `isDisabled` boolean, required — The webhook's disabled status
      - `featureType` string, required — The webhook's feature type
      - `entityId` string, nullable — The webhook's entity id as a string. `null` for broadcast webhooks.
      - `objectId` integer, nullable — Deprecated. The legacy numeric object id for this webhook.
      - `retryLimit` integer, required — The webhook's retry limit
      - `eventTypes` string[], required — The webhook's event types
      - `webhookVersion` integer — The version of the webhook payload schema
      - `origin` 'organic' | 'integration'
  - `paging` PagingResponseModelV2, required
    - `offset` integer, required — The resource offset of the last successfully read resource will be returned as the paging.offset JSON property of a paginated response containing more results
    - `total` integer, nullable — Total number of resources matching the request, ignoring pagination. Use this to retrieve the full count without paginating through every page. Only populated by endpoints that compute it.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/connecteam/apis/connecteam-api-documentation.md) · [All operations](https://skmtc.net/connecteam/apis/connecteam-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/connecteam/connecteam-api-documentation/revisions/d8f7f302222e/schema)