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

# [Deprecated] Get team webhooks

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

> **Deprecated.**

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' | 'DEV_MODE_STATUS_UPDATE', 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. This is deprecated, use context and context_id instead
    - `context` string, required — The type of context this webhook is attached to. The value will be "PROJECT", "TEAM", or "FILE"
    - `context_id` string, required — The ID of the context this webhook is attached to
    - `plan_api_id` string, required — The plan API ID of the team or organization where this webhook was created
    - `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. For security, when using the GET endpoints, the value is an empty string
    - `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.

## Changes

- **2026-05-06** `2c69c439e847` — 1 info
  - the endpoint scheme security `PlanAccessToken` was added to the API
- **2025-05-28** `4d8a8003d4e6` — 1 warning, 5 info
  - added the new `DEV_MODE_STATUS_UPDATE` enum value to the `webhooks/items/event_type` response property for the response status `200`
  - endpoint deprecated
  - response property `webhooks/items/team_id` deprecated
  - added the required property `webhooks/items/context` to the response with the `200` status
  - …2 more
- **2025-04-24** `8014b4aceb2f` — 1 info
  - the security scope `webhooks:read` was added to the endpoint's security scheme `OAuth2`
- **2023-12-14** `de5c0106668d` — 3 breaking, 5 info
  - removed the required property `webhooks/items/context` from the response with the `200` status
  - removed the required property `webhooks/items/context_id` from the response with the `200` status
  - removed the required property `webhooks/items/plan_api_id` from the response with the `200` status
  - the endpoint scheme security `PlanAccessToken` was removed from the API
  - …4 more

[Change history](https://skmtc.dev/figma/apis/figma-api/changes/v2/teams/:team_id/webhooks/get.md)

---

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