Figma FileUpdated

Figma FileUpdated
Certified
Trigger a flow when a Figma file is modified

Polls the Figma GET /v1/files/: key?depth=1 endpoint and compares the response's lastModified timestamp against the last value seen for this trigger. The first evaluation only records the timestamp — it never fires an execution, to avoid a spurious run when the trigger is first enabled. A 403 or 404 while polling (deleted or unshared file) fails the evaluation instead of silently keeping a stale timestamp.

yaml
type: io.kestra.plugin.figma.triggers.FileUpdated

Examples

Trigger a flow whenever a Figma file changes

yaml
id: figma_file_updated
namespace: company.team

tasks:
  - id: log_change
    type: io.kestra.plugin.core.log.Log
    message: "File {{ trigger.fileKey }} changed at {{ trigger.lastModified }}"

triggers:
  - id: file_updated
    type: io.kestra.plugin.figma.triggers.FileUpdated
    accessToken: "{{ secret('FIGMA_ACCESS_TOKEN') }}"
    fileKey: "abc123XYZ"
    interval: PT5M

Properties

accessToken *string

Figma access token

A personal access token generated from your Figma account settings (Account Settings > Personal access tokens), scoped to at least file read access. A valid OAuth 2.0 access token obtained through your own authorization flow also works — this plugin does not implement the OAuth flow itself, only PAT-style bearer tokens passed as-is.

fileKey *string

The Figma file key to watch

Found in the file's URL: https://www.figma.com/file/: fileKey/....

allowConcurrent boolean

Defaultfalse

Specifies whether a trigger is allowed to start a new execution even if a previous run is still in progress.

baseUrl string

Defaulthttps://api.figma.com/v1

Figma API base URL

Defaults to the public Figma REST API. Override only to point at a self-hosted proxy or a test server.

interval string

DefaultPT5M

Formatduration

The interval between two polls

stopAfter array

SubTypestring

Possible Values

CREATEDSUBMITTEDRUNNINGPAUSEDRESTARTEDKILLINGSUCCESSWARNINGFAILEDKILLEDCANCELLEDQUEUEDRETRYINGRETRIEDSKIPPEDBREAKPOINTRESUBMITTED

List of execution states after which a trigger should be stopped (a.k.a. disabled).

when string

Defaulttrue

A condition that determines whether the trigger should run.

A Pebble expression evaluated at trigger time. The trigger fires only when the expression evaluates to a truthy value (true, a non-empty string, a non-zero number). Use this to gate trigger execution on dynamic runtime values such as execution labels, flow variables, or environment conditions.

Outputs

fileKey string

The Figma file key that changed

lastModified string

Formatdate-time

The file's new lastModified timestamp