Figma Create

Figma Create

Certified

Create a comment on a Figma file

Calls the Figma POST /v1/files/: key/comments endpoint. Provide commentId to reply to an existing comment, or clientMeta to pin the comment to a canvas position or a node.

yaml
type: io.kestra.plugin.figma.comments.Create

Post a comment pinned to a canvas position on a Figma file

yaml
id: figma_create_comment
namespace: company.team

tasks:
  - id: create_comment
    type: io.kestra.plugin.figma.comments.Create
    accessToken: "{{ secret('FIGMA_ACCESS_TOKEN') }}"
    fileKey: "abc123XYZ"
    message: "This flow finished the design review."
    clientMeta:
      x: 100
      y: 200
Properties

Figma access token

A personal access token generated from your Figma account settings (Account Settings > Personal access tokens), scoped to what the task needs to do. 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.

The Figma file key

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

The comment message

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
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.

The position to pin the comment to

Either a canvas position (x/y), or a node anchor (node_id, optionally with node_offset). See the Figma API documentation for the full client_meta shape.

The ID of the comment to reply to

Omit to create a new top-level comment.

The ID of the created comment