Figma · AsyncAPI Specification
Figma Webhooks
Version 2.0.0
Figma Webhooks allow applications to receive real-time notifications when events occur in Figma files and projects. Webhooks are configured at the team level and send HTTP POST requests with JSON payloads to a specified endpoint URL. Supported events include file updates, comments, library publish changes, and version history updates. Webhooks use a passcode for payload verification.
View Spec
View on GitHub
CollaborationDesignGraphicsInterfacesPrototypesPrototypingUI/UXAsyncAPIWebhooksEvents
Channels
/webhook
Receive a Figma webhook event
The endpoint that receives all Figma webhook event deliveries. The specific event type is identified by the event_type field in the payload. Figma webhooks are team-scoped and can subscribe to specific event types.
Messages
ping
Ping Event
Test event sent when a webhook is first created to verify the endpoint is reachable.
file_update
File Update Event
Triggered when a file in the team is saved or modified.
file_version_update
File Version Update Event
Triggered when a named version is created in the file's version history.
file_delete
File Delete Event
Triggered when a file in the team is deleted.
file_comment
File Comment Event
Triggered when a new comment is posted on a file.
library_publish
Library Publish Event
Triggered when a library file publishes new components or styles.
Servers
https
webhook-receiver
{webhookUrl}
Your webhook receiver endpoint. Figma sends POST requests to this URL when subscribed events occur on the specified team. The endpoint must respond with a 200-level status code within 10 seconds.