
Figma Create
CertifiedCreate a comment on a Figma file
Figma Create
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.
type: io.kestra.plugin.figma.comments.CreateExamples
Post a comment pinned to a canvas position on a Figma file
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
accessToken *string
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.
fileKey *string
The Figma file key
Found in the file's URL: https://www.figma.com/file/: fileKey/....
message *string
The comment message
assets
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.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset 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.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150baseUrl string
https://api.figma.com/v1Figma API base URL
Defaults to the public Figma REST API. Override only to point at a self-hosted proxy or a test server.
clientMeta object
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.
commentId string
The ID of the comment to reply to
Omit to create a new top-level comment.
Outputs
id string
The ID of the created comment