Wiresk

Wiresk

Notion – Comments and Users

Estimated reading time: 3 min

What your automation will do…

A connection to your Notion account is needed so we can sync it with our platform.
Refer to Notion – create a connection.
You can include between 1 and 255 Methods to build complex Flows.
This Method is used to create a comment in a page or existing discussion thread.
 
● To add a new comment to an existing discussion thread, provide the discussion ID.
● New discussion thread cannot be created.

See Notion Create a comment API reference.

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*Create a Comment
Connection*Select your connection or create one.

Map Fields:

Page ID:

Select the page to create the comment.

⚠️ Either the page ID or discussion ID must be provided — not both.

Discussion ID:

ID of the existing discussion.

⚠️ Either the page ID or discussion ID must be provided — not both.

Comment*:

Provide the comment.

(*) required field

Response sample 
{
  "object": "comment",
  "id": "1cb41eaa-28f8-81f9-a9af-001d86cd4b62",
  "parent": {
    "type": "page_id",
    "page_id": "1c041eaa-28f8-8027-95f5-d35126d7da5e"
  },
  "discussion_id": "1cb41eaa-28f8-8127-930f-001c752c4816",
  "created_time": "2025-04-04T10:08:00.000Z",
  "last_edited_time": "2025-04-04T10:08:00.000Z",
  "created_by": {
    "object": "user",
    "id": "f889d775-ecb7-4b23-81e9-ebdbcef2e915"
  },
  "rich_text": [
    {
      "type": "text",
      "text": {
        "content": "test comment added with Wiresk",
        "link": null
      },
      "annotations": {
        "bold": false,
        "italic": false,
        "strikethrough": false,
        "underline": false,
        "code": false,
        "color": "default"
      },
      "plain_text": "test comment added with Wiresk",
      "href": null
    }
  ],
  "request_id": "ef5e947b-bdcb-4f75-87b8-4eb064d9cd24"
}
Expand
This Method is used to retrieve a list of un-resolved Comment objects from a page or block.
 
See Pagination for details about how to use a cursor to iterate through the list.

See Notion List comments API reference. 

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*List Comments
Connection*Select your connection or create one.

Matching Criteria:

Page ID or Block ID*:

Select the page or block that contains comments.

Map Fields:

Limit:

The number of items from the full list desired in the response. Maximum: 100

if not Found Consider as:

Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

Response sample 
[
  {
    "object": "comment",
    "id": "1cb41eaa-28f8-81f9-a9af-001d86cd4b62",
    "parent": {
      "type": "page_id",
      "page_id": "1c041eaa-28f8-8027-95f5-d35126d7da5e"
    },
    "discussion_id": "1cb41eaa-28f8-8127-930f-001c752c4816",
    "created_time": "2025-04-04T10:08:00.000Z",
    "last_edited_time": "2025-04-04T10:08:00.000Z",
    "created_by": {
      "object": "user",
      "id": "f889d775-ecb7-4b23-81e9-ebdbcef2e915"
    },
    "rich_text": [
      {
        "type": "text",
        "text": {
          "content": "test comment added with Wiresk",
          "link": null
        },
        "annotations": {
          "bold": false,
          "italic": false,
          "strikethrough": false,
          "underline": false,
          "code": false,
          "color": "default"
        },
        "plain_text": "test comment added with Wiresk",
        "href": null
      }
    ]
  }
]
Expand
This Method is used to retrieve a list of Notion users for the workspace. Guests are not included in the response.

See Notion List all users API reference. 

Configuration Table:

Input Options:

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: You can specify a fixed attribute.
Name*List Notion Users
Connection*Select your connection or create one.

Map Fields:

Limit:

The number of items from the full list desired in the response. Maximum: 100

(*) required field

Response sample 
[
  {
    "object": "user",
    "id": "4981eebd-51b9-4af6-9e28-9b11d6ab6a7e",
    "name": "Wiresk",
    "avatar_url": null,
    "type": "person",
    "person": {
      "email": "wiresktest@wiresk.com"
    }
  },
  {
    "object": "user",
    "id": "173d872b-594c-817c-b357-00025d7e188c",
    "name": "Chanara Ou",
    "avatar_url": null,
    "type": "person",
    "person": {
      "email": "user1@wiresk.com"
    }
  }
]
Expand

Once your Flow is configured, you can test or automate it using the Run panel or by managing Triggers from the Flow Management screen.

  • Run Flow: Manually runs the Flow once using sample data. Ideal for testing logic and field mapping. See How to Run a Flow.
  • Run Scheduler: Force-runs the Trigger immediately using live input. This bypasses the recurrence rule and is useful for verifying real data mapping. Learn more in Wiresk Scheduler – The Fundamentals.

From the Trigger management panel (clock icon), you can:

  • Activate or deactivate Triggers
  • Force-run the scheduler
  • Copy Routing Keys (for HTTP Triggers)

If your Flow uses a Webhook Trigger, it runs automatically on each incoming webhook—no scheduler required. It remains active until you manually deactivate it.