Every 15 minutes

Get told when a file is added to a Figma project

A new file in the project you watch is posted to Slack with its name and link.

Runs: Every 15 minutes
Apps: Figma
AI: Not needed
Access: folders:read (replaces the deprecated projects:read)

Send this to your assistant

Create a ClickRuntime automation: check my Figma 'Client work' project every 15 minutes and post to #design in Slack when a new file appears, with its name and link.

Paste it into your assistant. It tells you what it will send or change before it runs live.

Add to ChatGPT Add to Claude

First time? Adding ClickRuntime to your assistant takes about two minutes.

Why use it

Why teams use this automation

Figma projects grow quietly. A designer adds a new file for an onboarding flow, a contractor duplicates a component library, a PM creates a scratch file that becomes the source of truth. The rest of the team finds out weeks later when they notice an unfamiliar file in the sidebar, and by then work may have been done twice or against an outdated library. The cost is duplicated effort and designs that nobody can trace.

Every 15 minutes, ClickRuntime lists the files in a Figma project, compares their keys with those it saved earlier, and posts the names and links of new files to Slack. It then saves the updated keys so each file is announced once.

It suits design systems teams and agencies, where discovering new files promptly keeps work coordinated.

What you get out of it

Avoid duplicate design work
When a new file is announced, the team can check whether it overlaps with existing work. That prevents two designers from building the same flow in parallel. Duplicate flows mean wasted hours and inconsistent screens. Fixing a copied library later is far harder than catching it early.
Keep the library trustworthy
Component libraries need to be owned and known. Seeing new files lets the design system lead notice a rogue copy of the components before it spreads through projects. That shortens ramp-up for contractors and new hires alike.
Onboard people into new work
A link in the channel means a new teammate finds the file the day it appears. They can start contributing without searching or asking where the latest designs live. Early notice also helps capacity planning.
Maintain visibility for managers
Product managers can see that a new area of the product is getting design attention. Knowing a file exists helps them schedule reviews and plan dependent work. That awareness keeps reviews on the calendar.
Find stray or temporary files
Scratch files that become permanent are a common source of confusion. The alert shows them early, so you can rename, move or archive them while their purpose is still clear.

How it works

What happens, step by step

Every 15 minutes, ClickRuntime lists the files in your Figma project.
It compares them with the list saved last time.
Each new file is posted to your Slack channel with its name and a link. The updated list is saved for next time.

Before it runs live

Connect Figma

What you get

RunsEvery 15 minutes

Get told when a file is added to a Figma projecttoday, 9:00Succeeded

Slack · #designNew file in Client work: Acme - Q4 landing pages https://www.figma.com/design/v2W3x4Y5z6A7b8

Build your own

Need it to work differently?

This template is a starting point. Copy the prompt and change it, or describe a different automation from scratch, with your own conditions, more apps or an AI step. Your assistant writes it, tests it and runs it on ClickRuntime.

Your own rules
Conditions, thresholds, filters and exceptions, written the way you'd explain them to a colleague.
Any number of apps
One automation can read from one app and update several others. Over 248 apps are ready, and anything with an API works too.
AI where it helps
Summaries, classification, extraction and drafts use ClickRuntime's built-in AI, with no extra key.
On a schedule or on each event
Runs as often as every 5 minutes, or the moment an app sends an event, and keeps track of what it already handled.

Changes you can ask for

Act only on the items that match your own rules, and skip the rest
Add an AI step, for example to summarize, sort or draft a reply
Add another app, for example also send it to Slack
Combine it with other Figma steps into one automation

Under the hood

The code that runs this automation

This is the Python script that runs each time the automation starts. Your AI assistant writes it for you when you send the prompt, and you allow each step in your assistant. To change how the automation works, describe the change to your assistant and it updates the script for you. For every function it can use, see the script reference.

new_file_in_project_alert.pyexample

from clickruntime import on_trigger, report_fetched, state, notify, http, credentials

PROJECT_ID = "123456789"  # your 'Client work' project

@on_trigger
def run(event):
    files = http.get(f"https://api.figma.com/v1/projects/{PROJECT_ID}/files", headers={
        "Authorization": "Bearer " + credentials.connection("figma", "main")}).json()["files"]
    known = state.get("keys")
    new = [f for f in files if known is not None and f["key"] not in known]
    report_fetched(len(new))
    if known is not None and not new:
        return {"summary": "No new files"}
    for f in new:
        notify.slack(f"New file in Client work: {f['name']}\nhttps://www.figma.com/design/{f['key']}", channel="#design")
    state.set("keys", [f["key"] for f in files])
    return {"posted": len(new)}

FAQ

Common questions

Does it detect files moved between projects?

A file moved into the watched project has a new place in that project's list, so it is announced as new. Files moved out simply disappear from the list and no message is posted for them. Include the project name for clarity.

What does the Slack message contain?

The file name, a direct link to open it, and the project it belongs to. If Figma returns a thumbnail or last-modified time, those can be included as well so people can judge what the file is.

Can I watch several projects?

Yes. Add each project ID and the flow checks them in turn, remembering the file keys for each separately. You can post them to one channel or use a separate channel per project for larger organizations.

What permissions does it need?

folders:read (replaces the deprecated projects:read). Nothing else in your accounts is used.

Does it need AI?

No. It runs without AI, so it doesn't use your plan's AI allowance.

How many runs does it use?

One run each time it checks. Checks that find nothing new and stop right away aren't counted.

Can I change how it works?

Yes. Describe the change to your AI assistant, for example a different schedule, channel or filter. It updates the automation, tests it and tells you what changed.

Every 5–10 minutes