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

ActionWhat it does
Accept solutionMark a reply as the accepted solution to its topic, as the connected account (it needs the right to accept solutions on that board).
Add labelAdd a label to a message.
Add tagAdd a tag to a message.
Create memberAdd a member account to the community.
Create topicPost 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 memberDelete a member's account for good.
Delete messageDelete a topic or reply for good.
Get boardGet one board with its title, description, style and category.
Get memberGet one member's profile: user name, name, email, when they joined and last visited.
Get messageGet one topic or reply with its subject, body, author, board, thread, kudos and whether it's an accepted solution.
Give kudoGive a message a kudo (a like) from the connected account.
List boardsList the community's boards, optionally in one category or of one style, such as forums or blogs.
List categoriesList the community's categories, optionally only those inside one.
List kudosList kudos, newest first: those on a message, those a member gave, or those a member's posts received.
List labelsList the labels on a message.
List membersList the community's members, newest first, or find one by user name or email.
List messagesList 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 tagsList the tags on a message.
Mark as spam or not spamMark a message as spam, which takes it off the community into the spam quarantine, or as not spam, which puts it back.
Reply to messagePost a reply to a topic or to another reply, as the connected account.
Run LiQL queryRun 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 messageChange 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 IDmessage_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 IDmessage_idtextRequired
The message: its id, or a link to it on the community.
LabellabeltextRequired
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 IDmessage_idtextRequired
The message: its id, or a link to it on the community.
TagtagtextRequired
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 namelogintextRequired
Their user name, shown on everything they post.
EmailemailtextRequired
Their email address.
Passwordpasswordtext
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 namefirst_nametext
Their first name.
Last namelast_nametext
Their last name.
SSO IDsso_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

Boardboard_idtextRequired
The board to post in.
SubjectsubjecttextRequired
The topic's subject line.
BodybodytextRequired
The topic's text. HTML such as <p> and <a> is kept.
Tagstagslist
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 &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 IDmember_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 IDmessage_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

Boardboard_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 IDmember_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 IDmessage_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 &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 IDmessage_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

Categorycategory_idtext
Only boards directly in this category.
Board stylestyletext
Only boards of this style.One of: forum, blog, tkb (Knowledge base), idea (Idea exchange), qanda (Q&A), contest.
Most to returnlimitnumber
How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
Cursorcursortext
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 categoryparent_category_idtext
Only categories directly inside this one.
Most to returnlimitnumber
How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
Cursorcursortext
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 IDmessage_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 returnlimitnumber
How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
Cursorcursortext
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 IDmessage_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 namelogintext
Only the member with this user name.
Emailemailtext
Only the member with this email address.
Most to returnlimitnumber
How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
Cursorcursortext
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

Boardboard_idtext
Only messages in this board.
Topics or repliespost_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 IDtopic_idtext
Only this topic and its replies: the topic's id or a link to it.
Author IDauthor_idtext
Only messages by this member: their user id or profile link.
Labellabeltext
Only messages with this label, written exactly.
Tagtagtext
Only messages with this tag, written exactly.
Words in subjectsubject_wordstext
Only messages whose subject has these words.
Words in bodybody_wordstext
Only messages whose body has these words.
Posted afterposted_afterdate and time
Only messages posted at or after this time.
Posted beforeposted_beforedate and time
Only messages posted before this time.
Only accepted solutionssolutions_onlytrue/false
Turn on to list only replies accepted as solutions.
Orderordertext
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 returnlimitnumber
How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
Cursorcursortext
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 &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 IDmessage_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 IDmessage_idtextRequired
The message: its id, or a link to it on the community.
Mark asstatustextRequired
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 IDmessage_idtextRequired
The topic or reply to answer: its id or a link to it.
BodybodytextRequired
The reply's text. HTML such as <p> and <a> is kept.
Subjectsubjecttext
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 &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 queryquerytextRequired
A SELECT query on any collection (messages, boards, users, kudos and the rest). End it with LIMIT to choose how many come back.
Cursorcursortext
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 IDmessage_idtextRequired
The message: its id, or a link to it on the community.
New subjectsubjecttext
The new subject. Leave empty to keep it.
New bodybodytext
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 &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"
  }
}

On this page