figma-webhooks-events

# Figma Webhooks & Events ## Overview Figma Webhooks V2 push real-time notifications when files change, comments are posted, or libraries are published. Webhooks can be scoped to teams, projects, or individual files. Authentication uses a passcode echoed back in each payload. ## Prerequisites - HTTPS endpoint accessible from the internet - `FIGMA_PAT` with `webhooks:write` scope - Team ID (from Figma URL: `figma.com/files/team/<TEAM_ID>/...`) ## Instructions ### Step 1: Create a Webhook ```bash # POST /v2/webhooks -- requires webhooks:write scope curl -X POST https://api.figma.com/v2/webhooks \ -H "X-Figma-Token: ${FIGMA_PAT}" \ -H "Content-Type: application/json" \ -d '{ "event_type": "FILE_UPDATE", "team_id": "123456789", "endpoint": "https://yourapp.com/webhooks/figma", "passcode": "your-secret-passcode", "description": "Sync design tokens on file update" }' # Response: # { "id": "wh_abc123", "event_type": "FILE_UPDATE", "status": "ACTIVE", ... } ``` **Available event types:** | Event Type | Trigger | Payload Contains | |------------|---------|-----------------| | `FILE_UPDATE` | File saved to version history | `file_key`, `file_name`, `timestamp` | | `FILE_DELETE` | File deleted | `file_key`, `file_name` | | `FILE_VERSION_UPDATE` | Named version created | `file_key`, `version_id`, `label` | | `FILE_COMMENT` | Comment added | `file_key`, `comment`, `comment_id` | | `LIBRARY_PUBLISH` | Library published | `file_key`, `description`, variabl...