TumbleFlow turns product requirements in Notion into live, memory-backed Figma validation and AI-assisted fixes, so teams ship designs that actually match the spec.
python3 poll.py
ngrok http 5000
configure this url as your webhook in notion intgration
cd tumbleflow-upload
npm i
npm run buildbuild the packages and upload it on figma plugin, and just click to start. this help us in modifying stuffs on figma !
requests related to figma
curl -H "X-Figma-Token: $figma_personal_access_token" \
"https://api.figma.com/v1/teams/1597741680185956053/projects"
{"name":"cb.sc.u4aie23062's team","projects":[{"id":"541462135","name":"Team project"}]}
curl -H "X-Figma-Token: $figma_personal_access_token" \
"https://api.figma.com/v1/projects/541462135/files"
{"name":"Team project","files":[{"key":"8jcQA9DiUaOZeyPV4pghxW","name":"cb.sc.u4aie23062's team library","thumbnail_url":"https://s3-alpha.figma.com/thumbnails/f29d2542-17e9-4f96-934f-945376c0df7a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAQ4GOSFWC3LO4T7JF%2F20260319%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20260319T000000Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=583366649af3ad2e86566699f3825f414eb03e07bfc15431a5de06f27b2c1a43","last_modified":"2026-01-26T22:15:02Z"}]}
curl -H "X-Figma-Token: $figma_personal_access_token" \
"https://api.figma.com/v1/files/8jcQA9DiUaOZeyPV4pghxW"
{full json}
curl -H "X-Figma-Token: $figma_personal_access_token" \
"https://api.figma.com/v1/images/8jcQA9DiUaOZeyPV4pghxW?ids=0:1&format=png"
{"err":null,"images":{"0:1":"https://figma-alpha-api.s3.us-west-2.amazonaws.com/images/661cbe28-5c02-4004-bb29-19b9be21b3d6"}}
curl -X POST \
-H "X-Figma-Token: $figma_personal_access_token" \
-H "Content-Type: application/json" \
-d '{"message":"API test comment from validator"}' \
"https://api.figma.com/v1/files/8jcQA9DiUaOZeyPV4pghxW/comments"
{"id":"1684654765","uuid":null,"file_key":"8jcQA9DiUaOZeyPV4pghxW","parent_id":"","user":{"handle":"Sai Nivedh","img_url":"https://www.gravatar.com/avatar/626eb2ec938d61609912c495ca523e0d?size=240&default=https%3A%2F%2Fs3-alpha.figma.com%2Fstatic%2Fuser_s_v2.png","id":"1597741676359530927"},"created_at":"2026-03-22T07:30:18.386Z","resolved_at":null,"message":"API test comment from validator","reactions":[],"client_meta":{"x":0,"y":0},"order_id":"1"}
