Get Webhooks

Returns all webhook subscriptions registered for the specified team.

GET https://api.figma.com/v2/webhooks/:team_id

Authentication

Requires a valid access token with webhooks:write scope. Pass via X-Figma-Token header (personal access token) or Authorization: Bearer header (OAuth).

Parameters

Path parameters

The ID of the team to list webhooks for. Find your team ID in the Figma URL when viewing team settings.

Example Request

curl -X GET "https://api.figma.com/v2/webhooks/YOUR_TEAM_ID" \
  -H "X-Figma-Token: YOUR_TOKEN"

Response

{
  "webhooks": [
    {
      "id": "wh_123456",
      "event_type": "FILE_UPDATE",
      "team_id": "123456",
      "endpoint": "https://your-server.com/webhooks/figma",
      "status": "ACTIVE",
      "description": "File update notifications",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
`webhooks`	`array`	List of webhook subscription objects
`webhooks[].id`	`string`	Unique webhook identifier
`webhooks[].event_type`	`string`	The event type this webhook subscribes to
`webhooks[].team_id`	`string`	The team ID being watched
`webhooks[].endpoint`	`string`	The URL that receives webhook payloads
`webhooks[].status`	`string`	`ACTIVE` or `PAUSED`
`webhooks[].description`	`string`	Human-readable description
`webhooks[].created_at`	`string`	ISO 8601 creation timestamp

Use this endpoint to audit your webhook subscriptions. If a webhook has PAUSED status, it means Figma disabled it due to repeated delivery failures. Fix the endpoint and create a new webhook to resume.