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

Examples

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

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

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.

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.