---
title: "Get team webhooks"
method: GET
path: "/v2/teams/{team_id}/webhooks"
tags: ["Webhooks"]
---

# Get team webhooks

`GET /v2/teams/{team_id}/webhooks`

Returns all webhooks registered under the specified team.

## Path parameters

- `team_id` string, required

## Response `200`

Response from the GET /v2/teams/{team_id}/webhooks endpoint.

- object
  - `webhooks` WebhookV2[], required — An array of webhooks.
    - `id` string, required — The ID of the webhook
    - `event_type` 'PING' | 'FILE_UPDATE' | 'FILE_VERSION_UPDATE' | 'FILE_DELETE' | 'LIBRARY_PUBLISH' | 'FILE_COMMENT', required — An enum representing the possible events that a webhook can subscribe to
    - `team_id` string, required — The team id you are subscribed to for updates
    - `status` 'ACTIVE' | 'PAUSED', required — An enum representing the possible statuses you can set a webhook to: - `ACTIVE`: The webhook is healthy and receive all events - `PAUSED`: The webhook is paused and will not receive any events
    - `client_id` string, nullable, required — The client ID of the OAuth application that registered this webhook, if any
    - `passcode` string, required — The passcode that will be passed back to the webhook endpoint
    - `endpoint` string, required — The endpoint that will be hit when the webhook is triggered
    - `description` string, nullable, required — Optional user-provided description or name for the webhook. This is provided to help make maintaining a number of webhooks more convenient. Max length 140 characters.

## Other responses

- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `404` — The requested file or resource was not found.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

---

[API](https://skmtc.dev/thirdstrandstudio/apis/figma-api.md) · [All operations](https://skmtc.dev/thirdstrandstudio/apis/figma-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thirdstrandstudio/figma-api/revisions/48f84f49653a/schema)