I've been setting up a webhook integration to monitor file changes, and I ran into some confusing behavior with the FILE_UPDATED event. I'm sharing my findings here in case it helps someone else, and to confirm if this is the intended behavior.
My Setup:
- Plan: Professional Plan
- Authentication: Personal Access Token
- Scopes: My token has
webhooks:write,file_content:read, andfile_comments:readpermissions. - Integration Tool: I'm using n8n (a workflow automation tool) which receives the webhook events. My n8n instance has a public URL and is reachable by Figma.
- Webhook Event:
FILE_UPDATED
The Problem:
When I selected the
FILE_UPDATED event, I expected it to trigger when I made changes to a design file (e.g., moving an object, adding a shape, changing a color). However, no event was captured by my webhook endpoint while I was actively editing the file.What I Tested:
FILE_COMMENTEDworks perfectly: If I switched the event type toFILE_COMMENTEDand added a comment to the same file, the webhook fired instantly and my workflow received the data. This confirmed that my basic setup (token, scopes, webhook URL) was correct.FILE_UPDATEDdoesn't work on edit, only work delete file: When I switched back toFILE_UPDATED, making edits did nothing in real-time.
Hope this helps someone else save some time!
Thanks,
Hei
