Action: Create Comment

Figma Operation

The Create Comment action adds annotated feedback or notes directly on a design file for collaboration.

Example User Story

I want to give quick feedback on the new app button design, so I’ll use Figma’s Create Comment to pin my suggestions directly to the prototype for the team to review.

Fields

Field Name	Field Type	Required
fileKey	String	Yes
message	String	Yes
nodeId	String	No
clientToken	String	Yes

Related Connections

Figma

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "create-comment",
  "state": "inDev",
  "meta": {
    "short": "Create Comment",
    "description": "Creates a new comment on a Figma file or frame."
  },
  "input": [
    {
      "name": "fileKey",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The key of the Figma file where the comment will be created."
      }
    },
    {
      "name": "message",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The content of the comment."
      }
    },
    {
      "name": "nodeId",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The ID of the node (frame, group, etc.) to attach the comment to. If omitted, the comment will be on the entire file."
      }
    },
    {
      "name": "clientToken",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The client token for authentication with the Figma API."
      }
    }
  ],
  "output": [
    {
      "name": "commentId",
      "type": "String",
      "selector": ["id"],
      "meta": {
        "description": "The ID of the created comment."
      }
    },
    {
      "name": "comment",
      "type": "Object",
      "selector": [],
      "meta": {
        "description": "The full comment object returned by the Figma API."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "https://api.figma.com/v1/files/{{fileKey}}/comments",
        "headers": {
          "Content-Type": "application/json",
          "X-Figma-Token": "{{clientToken}}"
        },
        "bodyTemplate": {
          "value": "{\"message\": \"{{message}}\", \"node_id\": \"{{nodeId}}\"}",
          "placeholders": [
            {
              "name": "message",
              "type": "String",
              "description": "The content of the comment.",
              "required": true
            },
            {
              "name": "nodeId",
              "type": "String",
              "description": "The ID of the node to attach the comment to.",
              "required": false
            }
          ]
        }
      }
    }
  ]
}