Khoros
App · 22 actions
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.
Actions
| Action | What it does |
|---|---|
| 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). |
| Add label | Add a label to a message. |
| Add tag | Add a tag to a message. |
| Create member | Add a member account to the community. |
| 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. |
| Delete member | Delete a member's account for good. |
| Delete message | Delete a topic or reply for good. |
| Get board | Get one board with its title, description, style and category. |
| Get member | Get one member's profile: user name, name, email, when they joined and last visited. |
| Get message | Get one topic or reply with its subject, body, author, board, thread, kudos and whether it's an accepted solution. |
| Give kudo | Give a message a kudo (a like) from the connected account. |
| List boards | List the community's boards, optionally in one category or of one style, such as forums or blogs. |
| List categories | List the community's categories, optionally only those inside one. |
| List kudos | List kudos, newest first: those on a message, those a member gave, or those a member's posts received. |
| List labels | List the labels on a message. |
| List members | List the community's members, newest first, or find one by user name or email. |
| 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. |
| List tags | List the tags on a message. |
| 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. |
| Reply to message | Post a reply to a topic or to another reply, as the connected account. |
| 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. |
| Update message | Change a topic's or reply's subject, body or both. |
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_idtextRequired - The reply to accept: its id or a link to it.
Outputs
message_idtext- The reply accepted
solutionobject- The accepted solution
Example output
{
"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_idtextRequired - The message: its id, or a link to it on the community.
- Label
labeltextRequired - The label's text, such as How-to.
Outputs
labelobject- A label
message_idtext- The message labelled
Example output
{
"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_idtextRequired - The message: its id, or a link to it on the community.
- Tag
tagtextRequired - The tag's text, such as reports.
Outputs
message_idtext- The message tagged
tagobject- A tag
Example output
{
"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
logintextRequired - Their user name, shown on everything they post.
- Email
emailtextRequired - Their email address.
- Password
passwordtext - 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_nametext - Their first name.
- Last name
last_nametext - Their last name.
- SSO ID
sso_idtext - Their id in your single sign-on system, if the community uses one.
Outputs
userobject- A community member
Example output
{
"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_idtextRequired - The board to post in.
- Subject
subjecttextRequired - The topic's subject line.
- Body
bodytextRequired - The topic's text. HTML such as <p> and <a> is kept.
- Tags
tagslist - Tags to put on the topic.
Outputs
messageobject- A topic or reply
Example output
{
"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 > 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_idtextRequired - The member to delete: their user id or profile link.
Outputs
deletedtrue/false- True once deleted
user_idtext- The member deleted
Example output
{
"deleted": true,
"user_id": "6148"
}Delete message
Delete a topic or reply for good. Deleting a topic deletes its replies.
Inputs
- Message ID
message_idtextRequired - The message to delete: its id or a link to it.
Outputs
deletedtrue/false- True once deleted
message_idtext- The message deleted
Example output
{
"deleted": true,
"message_id": "2561057"
}Get board
Get one board with its title, description, style and category.
Inputs
- Board
board_idtextRequired - The board.
Outputs
boardobject- A board
Example output
{
"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_idtextRequired - The member: their user id or profile link.
Outputs
userobject- A community member
Example output
{
"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_idtextRequired - The message: its id, or a link to it on the community.
Outputs
messageobject- A topic or reply
Example output
{
"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 > 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_idtextRequired - The message: its id, or a link to it on the community.
Outputs
kudoobject- A kudo
message_idtext- The message
Example output
{
"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_idtext - Only boards directly in this category.
- Board style
styletext - Only boards of this style.One of:
forum,blog,tkb(Knowledge base),idea(Idea exchange),qanda(Q&A),contest. - Most to return
limitnumber - How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.
Outputs
boardslist- The boards
countnumber- How many came back on this page
next_cursortext- Give this as Cursor to get the next page; empty when there are no more
Example output
{
"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_idtext - Only categories directly inside this one.
- Most to return
limitnumber - How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.
Outputs
categorieslist- The categories
countnumber- How many came back on this page
next_cursortext- Give this as Cursor to get the next page; empty when there are no more
Example output
{
"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_idtext - Kudos on this message: its id or a link to it.
- Given by (user ID)
given_bytext - Kudos this member gave: their user id or profile link.
- Received by (user ID)
received_bytext - Kudos on this member's posts: their user id or profile link.
- Most to return
limitnumber - How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.
Outputs
countnumber- How many came back on this page
kudoslist- The kudos
next_cursortext- Give this as Cursor to get the next page; empty when there are no more
Example output
{
"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_idtextRequired - The message: its id, or a link to it on the community.
Outputs
countnumber- How many came back on this page
labelslist- Its labels
message_idtext- The message
next_cursortext- Give this as Cursor to get the next page; empty when there are no more
Example output
{
"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
logintext - Only the member with this user name.
- Email
emailtext - Only the member with this email address.
- Most to return
limitnumber - How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.
Outputs
countnumber- How many came back on this page
next_cursortext- Give this as Cursor to get the next page; empty when there are no more
userslist- The members
Example output
{
"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_idtext - Only messages in this board.
- Topics or replies
post_typetext - 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_idtext - Only this topic and its replies: the topic's id or a link to it.
- Author ID
author_idtext - Only messages by this member: their user id or profile link.
- Label
labeltext - Only messages with this label, written exactly.
- Tag
tagtext - Only messages with this tag, written exactly.
- Words in subject
subject_wordstext - Only messages whose subject has these words.
- Words in body
body_wordstext - Only messages whose body has these words.
- Posted after
posted_afterdate and time - Only messages posted at or after this time.
- Posted before
posted_beforedate and time - Only messages posted before this time.
- Only accepted solutions
solutions_onlytrue/false - Turn on to list only replies accepted as solutions.
- Order
ordertext - 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
limitnumber - How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.
Outputs
countnumber- How many came back on this page
messageslist- The messages
next_cursortext- Give this as Cursor to get the next page; empty when there are no more
Example output
{
"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 > 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_idtextRequired - The message: its id, or a link to it on the community.
Outputs
countnumber- How many came back on this page
message_idtext- The message
next_cursortext- Give this as Cursor to get the next page; empty when there are no more
tagslist- Its tags
Example output
{
"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_idtextRequired - The message: its id, or a link to it on the community.
- Mark as
statustextRequired - Spam, or not spam.One of:
spam,not_spam(Not spam).
Outputs
message_idtext- The message
statustext- spam or not_spam
Example output
{
"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_idtextRequired - The topic or reply to answer: its id or a link to it.
- Body
bodytextRequired - The reply's text. HTML such as <p> and <a> is kept.
- Subject
subjecttext - The reply's subject. Defaults to Re: and the message's subject.
Outputs
messageobject- A topic or reply
Example output
{
"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 > 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
querytextRequired - A SELECT query on any collection (messages, boards, users, kudos and the rest). End it with LIMIT to choose how many come back.
- Cursor
cursortext - To read on, the next_cursor an earlier run of this step gave. Leave empty for the first page.
Outputs
countnumber- How many came back, or the total of a count(*) query
itemslist- What the query found, with the fields it selected
next_cursortext- Give this as Cursor to get the next page; empty when there are no more
typetext- The collection read, such as messages
Example output
{
"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_idtextRequired - The message: its id, or a link to it on the community.
- New subject
subjecttext - The new subject. Leave empty to keep it.
- New body
bodytext - The new text, which replaces the old. Leave empty to keep it.
Outputs
messageobject- A topic or reply
Example output
{
"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 > 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"
}
}