# Khoros

> Work with your Khoros community: post topics and replies, label, tag, kudo and moderate messages, accept solutions, manage members, run LiQL queries, and start workflows on new topics, replies, solutions, members and kudos.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/khoros

## Actions

### Accept solution

Mark a reply as the accepted solution to its topic, as the connected account (it needs the right to accept solutions on that board).

**Inputs**

- Message ID (`message_id`, text, required): The reply to accept: its id or a link to it.

**Outputs**

- `message_id` (text): The reply accepted
- `solution` (object): The accepted solution

**Example output**

```json
{
  "message_id": "2561057",
  "solution": {
    "accepter": {
      "id": "6148",
      "login": "jordan",
      "type": "user",
      "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
    },
    "message_id": "2561057",
    "time": "2026-11-11T05:53:36.000-08:00"
  }
}
```

### Add label

Add a label to a message. A board set to predefined labels only takes one of its own.

**Inputs**

- Message ID (`message_id`, text, required): The message: its id, or a link to it on the community.
- Label (`label`, text, required): The label's text, such as How-to.

**Outputs**

- `label` (object): A label
- `message_id` (text): The message labelled

**Example output**

```json
{
  "label": {
    "id": "How-to",
    "text": "How-to",
    "time": "2020-06-12T01:20:22.958-07:00",
    "type": "label"
  },
  "message_id": "2561037"
}
```

### Add tag

Add a tag to a message.

**Inputs**

- Message ID (`message_id`, text, required): The message: its id, or a link to it on the community.
- Tag (`tag`, text, required): The tag's text, such as reports.

**Outputs**

- `message_id` (text): The message tagged
- `tag` (object): A tag

**Example output**

```json
{
  "message_id": "2561037",
  "tag": {
    "id": "reports",
    "text": "reports",
    "time": "2026-11-09T09:42:30.126-08:00",
    "type": "tag"
  }
}
```

### Create member

Add a member account to the community.

**Inputs**

- User name (`login`, text, required): Their user name, shown on everything they post.
- Email (`email`, text, required): Their email address.
- Password (`password`, text): Their password, for a member who signs in on the community itself. Leave empty for one who signs in through single sign-on, and give their SSO ID.
- First name (`first_name`, text): Their first name.
- Last name (`last_name`, text): Their last name.
- SSO ID (`sso_id`, text): Their id in your single sign-on system, if the community uses one.

**Outputs**

- `user` (object): A community member

**Example output**

```json
{
  "user": {
    "email": "jordan@example.com",
    "first_name": "Jordan",
    "id": "6148",
    "last_name": "Lee",
    "last_visit_time": "2026-11-12T08:15:02.000-08:00",
    "login": "jordan",
    "registration_data": {
      "registration_time": "2026-02-20T14:01:35.597-08:00",
      "status": "fully-registered"
    },
    "type": "user",
    "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
  }
}
```

### Create topic

Post a new topic (a discussion, question, blog post or idea, as the board's style has it) to a board, as the connected account.

**Inputs**

- Board (`board_id`, text, required): The board to post in.
- Subject (`subject`, text, required): The topic's subject line.
- Body (`body`, text, required): The topic's text. HTML such as <p> and <a> is kept.
- Tags (`tags`, list): Tags to put on the topic.

**Outputs**

- `message` (object): A topic or reply

**Example output**

```json
{
  "message": {
    "author": {
      "id": "6148",
      "login": "jordan",
      "type": "user",
      "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
    },
    "board": {
      "id": "product-questions",
      "type": "board",
      "view_href": "https://community.example.com/t5/Product-Questions/bd-p/product-questions"
    },
    "body": "<P>Use Reports &gt; Export and pick CSV.</P>",
    "conversation": {
      "id": "2561037",
      "last_post_time": "2026-11-11T05:53:25.854-08:00",
      "messages_count": 3,
      "solved": true,
      "style": "forum"
    },
    "depth": 0,
    "id": "2561037",
    "is_solution": false,
    "kudos": {
      "sum": {
        "weight": 2
      }
    },
    "metrics": {
      "views": 157
    },
    "moderation_status": "approved",
    "parent": {
      "id": "2561037",
      "type": "message",
      "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561037"
    },
    "post_time": "2026-11-09T09:42:30.126-08:00",
    "read_only": false,
    "solution_data": {},
    "subject": "Exporting reports",
    "teaser": "",
    "topic": {
      "id": "2561037",
      "type": "message",
      "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561037"
    },
    "type": "message",
    "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561057"
  }
}
```

### Delete member

Delete a member's account for good.

**Inputs**

- User ID (`member_id`, text, required): The member to delete: their user id or profile link.

**Outputs**

- `deleted` (true/false): True once deleted
- `user_id` (text): The member deleted

**Example output**

```json
{
  "deleted": true,
  "user_id": "6148"
}
```

### Delete message

Delete a topic or reply for good. Deleting a topic deletes its replies.

**Inputs**

- Message ID (`message_id`, text, required): The message to delete: its id or a link to it.

**Outputs**

- `deleted` (true/false): True once deleted
- `message_id` (text): The message deleted

**Example output**

```json
{
  "deleted": true,
  "message_id": "2561057"
}
```

### Get board

Get one board with its title, description, style and category.

**Inputs**

- Board (`board_id`, text, required): The board.

**Outputs**

- `board` (object): A board

**Example output**

```json
{
  "board": {
    "conversation_style": "forum",
    "description": "Ask how to do anything in the product.",
    "id": "product-questions",
    "parent_category": {
      "id": "support"
    },
    "title": "Product Questions",
    "type": "board",
    "view_href": "https://community.example.com/t5/Product-Questions/bd-p/product-questions"
  }
}
```

### Get member

Get one member's profile: user name, name, email, when they joined and last visited.

**Inputs**

- User ID (`member_id`, text, required): The member: their user id or profile link.

**Outputs**

- `user` (object): A community member

**Example output**

```json
{
  "user": {
    "email": "jordan@example.com",
    "first_name": "Jordan",
    "id": "6148",
    "last_name": "Lee",
    "last_visit_time": "2026-11-12T08:15:02.000-08:00",
    "login": "jordan",
    "registration_data": {
      "registration_time": "2026-02-20T14:01:35.597-08:00",
      "status": "fully-registered"
    },
    "type": "user",
    "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
  }
}
```

### Get message

Get one topic or reply with its subject, body, author, board, thread, kudos and whether it's an accepted solution.

**Inputs**

- Message ID (`message_id`, text, required): The message: its id, or a link to it on the community.

**Outputs**

- `message` (object): A topic or reply

**Example output**

```json
{
  "message": {
    "author": {
      "id": "6148",
      "login": "jordan",
      "type": "user",
      "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
    },
    "board": {
      "id": "product-questions",
      "type": "board",
      "view_href": "https://community.example.com/t5/Product-Questions/bd-p/product-questions"
    },
    "body": "<P>Use Reports &gt; Export and pick CSV.</P>",
    "conversation": {
      "id": "2561037",
      "last_post_time": "2026-11-11T05:53:25.854-08:00",
      "messages_count": 3,
      "solved": true,
      "style": "forum"
    },
    "depth": 1,
    "id": "2561057",
    "is_solution": true,
    "kudos": {
      "sum": {
        "weight": 2
      }
    },
    "metrics": {
      "views": 157
    },
    "moderation_status": "approved",
    "parent": {
      "id": "2561037",
      "type": "message",
      "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561037"
    },
    "post_time": "2026-11-09T09:42:30.126-08:00",
    "read_only": false,
    "solution_data": {
      "accepter": {
        "id": "6148",
        "login": "jordan",
        "type": "user",
        "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
      },
      "message_id": "2561057",
      "time": "2026-11-11T05:53:36.000-08:00"
    },
    "subject": "Re: Exporting reports",
    "teaser": "",
    "topic": {
      "id": "2561037",
      "type": "message",
      "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561037"
    },
    "type": "message",
    "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561057"
  }
}
```

### Give kudo

Give a message a kudo (a like) from the connected account. Khoros doesn't let an account kudo its own posts.

**Inputs**

- Message ID (`message_id`, text, required): The message: its id, or a link to it on the community.

**Outputs**

- `kudo` (object): A kudo
- `message_id` (text): The message

**Example output**

```json
{
  "kudo": {
    "id": "546855",
    "message": {
      "id": "2561057",
      "type": "message",
      "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561057"
    },
    "time": "2026-11-12T11:28:00.000-08:00",
    "type": "kudo",
    "user": {
      "id": "6148",
      "login": "jordan",
      "type": "user",
      "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
    },
    "weight": 1
  },
  "message_id": "2561057"
}
```

### List boards

List the community's boards, optionally in one category or of one style, such as forums or blogs.

**Inputs**

- Category (`category_id`, text): Only boards directly in this category.
- Board style (`style`, text): Only boards of this style. One of: `forum`, `blog`, `tkb` (Knowledge base), `idea` (Idea exchange), `qanda` (Q&A), `contest`.
- Most to return (`limit`, number): How many to return, 1 to 1000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.

**Outputs**

- `boards` (list): The boards
- `count` (number): How many came back on this page
- `next_cursor` (text): Give this as Cursor to get the next page; empty when there are no more

**Example output**

```json
{
  "boards": [
    {
      "conversation_style": "forum",
      "description": "Ask how to do anything in the product.",
      "id": "product-questions",
      "parent_category": {
        "id": "support"
      },
      "title": "Product Questions",
      "type": "board",
      "view_href": "https://community.example.com/t5/Product-Questions/bd-p/product-questions"
    }
  ],
  "count": 1,
  "next_cursor": ""
}
```

### List categories

List the community's categories, optionally only those inside one.

**Inputs**

- Parent category (`parent_category_id`, text): Only categories directly inside this one.
- Most to return (`limit`, number): How many to return, 1 to 1000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.

**Outputs**

- `categories` (list): The categories
- `count` (number): How many came back on this page
- `next_cursor` (text): Give this as Cursor to get the next page; empty when there are no more

**Example output**

```json
{
  "categories": [
    {
      "id": "support",
      "parent_category": {
        "id": "help"
      },
      "title": "Support",
      "type": "category",
      "view_href": "https://community.example.com/t5/Support/ct-p/support"
    }
  ],
  "count": 1,
  "next_cursor": ""
}
```

### List kudos

List kudos, newest first: those on a message, those a member gave, or those a member's posts received. Give at least one of the three.

**Inputs**

- Message ID (`message_id`, text): Kudos on this message: its id or a link to it.
- Given by (user ID) (`given_by`, text): Kudos this member gave: their user id or profile link.
- Received by (user ID) (`received_by`, text): Kudos on this member's posts: their user id or profile link.
- Most to return (`limit`, number): How many to return, 1 to 1000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.

**Outputs**

- `count` (number): How many came back on this page
- `kudos` (list): The kudos
- `next_cursor` (text): Give this as Cursor to get the next page; empty when there are no more

**Example output**

```json
{
  "count": 1,
  "kudos": [
    {
      "id": "546855",
      "message": {
        "id": "2561057",
        "type": "message",
        "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561057"
      },
      "time": "2026-11-12T11:28:00.000-08:00",
      "type": "kudo",
      "user": {
        "id": "6148",
        "login": "jordan",
        "type": "user",
        "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
      },
      "weight": 1
    }
  ],
  "next_cursor": ""
}
```

### List labels

List the labels on a message.

**Inputs**

- Message ID (`message_id`, text, required): The message: its id, or a link to it on the community.

**Outputs**

- `count` (number): How many came back on this page
- `labels` (list): Its labels
- `message_id` (text): The message
- `next_cursor` (text): Give this as Cursor to get the next page; empty when there are no more

**Example output**

```json
{
  "count": 1,
  "labels": [
    {
      "id": "How-to",
      "text": "How-to",
      "time": "2020-06-12T01:20:22.958-07:00",
      "type": "label"
    }
  ],
  "message_id": "2561037",
  "next_cursor": ""
}
```

### List members

List the community's members, newest first, or find one by user name or email. Emails show only to an account allowed to see them.

**Inputs**

- User name (`login`, text): Only the member with this user name.
- Email (`email`, text): Only the member with this email address.
- Most to return (`limit`, number): How many to return, 1 to 1000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.

**Outputs**

- `count` (number): How many came back on this page
- `next_cursor` (text): Give this as Cursor to get the next page; empty when there are no more
- `users` (list): The members

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "users": [
    {
      "email": "jordan@example.com",
      "first_name": "Jordan",
      "id": "6148",
      "last_name": "Lee",
      "last_visit_time": "2026-11-12T08:15:02.000-08:00",
      "login": "jordan",
      "registration_data": {
        "registration_time": "2026-02-20T14:01:35.597-08:00",
        "status": "fully-registered"
      },
      "type": "user",
      "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
    }
  ]
}
```

### List messages

List topics and replies, filtered by board, topic, author, label, tag, words in the subject or body, date, or accepted solutions, newest, oldest or most kudos first. Gets one page; to see more, run it again with the cursor it gives.

**Inputs**

- Board (`board_id`, text): Only messages in this board.
- Topics or replies (`post_type`, text): Which messages to list. Defaults to topics and replies. One of: `all` (Topics and replies), `topics` (Topics only), `replies` (Replies only). Default: `all`.
- Topic ID (`topic_id`, text): Only this topic and its replies: the topic's id or a link to it.
- Author ID (`author_id`, text): Only messages by this member: their user id or profile link.
- Label (`label`, text): Only messages with this label, written exactly.
- Tag (`tag`, text): Only messages with this tag, written exactly.
- Words in subject (`subject_words`, text): Only messages whose subject has these words.
- Words in body (`body_words`, text): Only messages whose body has these words.
- Posted after (`posted_after`, date and time): Only messages posted at or after this time.
- Posted before (`posted_before`, date and time): Only messages posted before this time.
- Only accepted solutions (`solutions_only`, true/false): Turn on to list only replies accepted as solutions.
- Order (`order`, text): Newest, oldest or most kudos first. Defaults to newest first. One of: `newest` (Newest first), `oldest` (Oldest first), `most_kudos` (Most kudos first). Default: `newest`.
- Most to return (`limit`, number): How many to return, 1 to 1000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.

**Outputs**

- `count` (number): How many came back on this page
- `messages` (list): The messages
- `next_cursor` (text): Give this as Cursor to get the next page; empty when there are no more

**Example output**

```json
{
  "count": 1,
  "messages": [
    {
      "author": {
        "id": "6148",
        "login": "jordan",
        "type": "user",
        "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
      },
      "board": {
        "id": "product-questions",
        "type": "board",
        "view_href": "https://community.example.com/t5/Product-Questions/bd-p/product-questions"
      },
      "body": "<P>Use Reports &gt; Export and pick CSV.</P>",
      "conversation": {
        "id": "2561037",
        "last_post_time": "2026-11-11T05:53:25.854-08:00",
        "messages_count": 3,
        "solved": true,
        "style": "forum"
      },
      "depth": 1,
      "id": "2561057",
      "is_solution": true,
      "kudos": {
        "sum": {
          "weight": 2
        }
      },
      "metrics": {
        "views": 157
      },
      "moderation_status": "approved",
      "parent": {
        "id": "2561037",
        "type": "message",
        "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561037"
      },
      "post_time": "2026-11-09T09:42:30.126-08:00",
      "read_only": false,
      "solution_data": {
        "accepter": {
          "id": "6148",
          "login": "jordan",
          "type": "user",
          "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
        },
        "message_id": "2561057",
        "time": "2026-11-11T05:53:36.000-08:00"
      },
      "subject": "Re: Exporting reports",
      "teaser": "",
      "topic": {
        "id": "2561037",
        "type": "message",
        "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561037"
      },
      "type": "message",
      "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561057"
    }
  ],
  "next_cursor": ""
}
```

### List tags

List the tags on a message.

**Inputs**

- Message ID (`message_id`, text, required): The message: its id, or a link to it on the community.

**Outputs**

- `count` (number): How many came back on this page
- `message_id` (text): The message
- `next_cursor` (text): Give this as Cursor to get the next page; empty when there are no more
- `tags` (list): Its tags

**Example output**

```json
{
  "count": 1,
  "message_id": "2561037",
  "next_cursor": "",
  "tags": [
    {
      "id": "reports",
      "text": "reports",
      "time": "2026-11-09T09:42:30.126-08:00",
      "type": "tag"
    }
  ]
}
```

### Mark as spam or not spam

Mark a message as spam, which takes it off the community into the spam quarantine, or as not spam, which puts it back.

**Inputs**

- Message ID (`message_id`, text, required): The message: its id, or a link to it on the community.
- Mark as (`status`, text, required): Spam, or not spam. One of: `spam`, `not_spam` (Not spam).

**Outputs**

- `message_id` (text): The message
- `status` (text): spam or not_spam

**Example output**

```json
{
  "message_id": "2561057",
  "status": "spam"
}
```

### Reply to message

Post a reply to a topic or to another reply, as the connected account.

**Inputs**

- Message ID (`message_id`, text, required): The topic or reply to answer: its id or a link to it.
- Body (`body`, text, required): The reply's text. HTML such as <p> and <a> is kept.
- Subject (`subject`, text): The reply's subject. Defaults to Re: and the message's subject.

**Outputs**

- `message` (object): A topic or reply

**Example output**

```json
{
  "message": {
    "author": {
      "id": "6148",
      "login": "jordan",
      "type": "user",
      "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
    },
    "board": {
      "id": "product-questions",
      "type": "board",
      "view_href": "https://community.example.com/t5/Product-Questions/bd-p/product-questions"
    },
    "body": "<P>Use Reports &gt; Export and pick CSV.</P>",
    "conversation": {
      "id": "2561037",
      "last_post_time": "2026-11-11T05:53:25.854-08:00",
      "messages_count": 3,
      "solved": true,
      "style": "forum"
    },
    "depth": 1,
    "id": "2561057",
    "is_solution": true,
    "kudos": {
      "sum": {
        "weight": 2
      }
    },
    "metrics": {
      "views": 157
    },
    "moderation_status": "approved",
    "parent": {
      "id": "2561037",
      "type": "message",
      "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561037"
    },
    "post_time": "2026-11-09T09:42:30.126-08:00",
    "read_only": false,
    "solution_data": {
      "accepter": {
        "id": "6148",
        "login": "jordan",
        "type": "user",
        "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
      },
      "message_id": "2561057",
      "time": "2026-11-11T05:53:36.000-08:00"
    },
    "subject": "Re: Exporting reports",
    "teaser": "",
    "topic": {
      "id": "2561037",
      "type": "message",
      "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561037"
    },
    "type": "message",
    "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561057"
  }
}
```

### Run LiQL query

Run a LiQL query, Khoros's SQL-like way to read the community, such as SELECT id, subject FROM messages WHERE board.id = 'ideas' ORDER BY post_time DESC LIMIT 10, and get what it finds.

**Inputs**

- LiQL query (`query`, text, required): A SELECT query on any collection (messages, boards, users, kudos and the rest). End it with LIMIT to choose how many come back.
- Cursor (`cursor`, text): To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.

**Outputs**

- `count` (number): How many came back, or the total of a count(*) query
- `items` (list): What the query found, with the fields it selected
- `next_cursor` (text): Give this as Cursor to get the next page; empty when there are no more
- `type` (text): The collection read, such as messages

**Example output**

```json
{
  "count": 1,
  "items": [
    {
      "id": "2561057",
      "subject": "Re: Exporting reports",
      "type": "message"
    }
  ],
  "next_cursor": "",
  "type": "messages"
}
```

### Update message

Change a topic's or reply's subject, body or both.

**Inputs**

- Message ID (`message_id`, text, required): The message: its id, or a link to it on the community.
- New subject (`subject`, text): The new subject. Leave empty to keep it.
- New body (`body`, text): The new text, which replaces the old. Leave empty to keep it.

**Outputs**

- `message` (object): A topic or reply

**Example output**

```json
{
  "message": {
    "author": {
      "id": "6148",
      "login": "jordan",
      "type": "user",
      "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
    },
    "board": {
      "id": "product-questions",
      "type": "board",
      "view_href": "https://community.example.com/t5/Product-Questions/bd-p/product-questions"
    },
    "body": "<P>Use Reports &gt; Export and pick CSV.</P>",
    "conversation": {
      "id": "2561037",
      "last_post_time": "2026-11-11T05:53:25.854-08:00",
      "messages_count": 3,
      "solved": true,
      "style": "forum"
    },
    "depth": 1,
    "id": "2561057",
    "is_solution": true,
    "kudos": {
      "sum": {
        "weight": 2
      }
    },
    "metrics": {
      "views": 157
    },
    "moderation_status": "approved",
    "parent": {
      "id": "2561037",
      "type": "message",
      "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561037"
    },
    "post_time": "2026-11-09T09:42:30.126-08:00",
    "read_only": false,
    "solution_data": {
      "accepter": {
        "id": "6148",
        "login": "jordan",
        "type": "user",
        "view_href": "https://community.example.com/t5/user/viewprofilepage/user-id/6148"
      },
      "message_id": "2561057",
      "time": "2026-11-11T05:53:36.000-08:00"
    },
    "subject": "Re: Exporting reports",
    "teaser": "",
    "topic": {
      "id": "2561037",
      "type": "message",
      "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561037"
    },
    "type": "message",
    "view_href": "https://community.example.com/t5/Product-Questions/Exporting-reports/m-p/2561057"
  }
}
```
