Create an Idea Status

Statuses play a crucial role in organizing ideas and letting community members know where an idea is in the review/approval process.

The statuses you create vary, based on the purpose of the Ideas board. If you’re soliciting product ideas, for example, statuses should reflect a progression from a new idea, through review, to eventual implementation, or indicate that an idea has been rejected.

When an Ideas board is created, Khoros includes several out-of-the-box statuses. You can edit or delete these statuses, as well as add new ones specific to your needs. You can only create or edit statuses at the Ideas board level.

To provide better reporting and analytics, statuses are grouped into various Status Sets.

Each new Ideas board includes the following statuses:

Status Set	Statuses	Description
New	Unspecified	The Idea that has no status label visible to members.
	New	A newly submitted idea awaiting team review.
In Progress	In Review	The idea is being investigated and scoped by the team.
	Accepted	The idea has been accepted by the team.
On Hold	Needs info	More information is needed from the author of this idea.
	Future Consideration	The idea has been accepted by the team but is considered for future implementation.
Completed	Delivered	The idea has been successfully completed and delivered to customers.
Closed	Declined	The idea has been rejected by the team.
	Already Exists	A similar idea has already been submitted or delivered.

This guide will teach you how to create new statuses using a GraphQL API call.

Requirements

You must have the Create or delete statuses for ideas and Edit board settings permissions set to Grant by the Administrator.

Example

In this example, you want to create teststatus in the Idea board idea1.

In the createIdeaStatus mutation, you indicate the board ID where you want the idea status, status group key from the pre-defined values specified in the table (new, in_progress, on_hold, completed, closed), unique status key, name of the idea status, label visibility, label type (TEXTONLY, OUTLINE, FILLED), and label color code.

Create Idea Status Mutation

mutation {
  createIdeaStatus(
    boardId: "board:idea1", 
    statusKey: "test_status", 
    statusGroupKey: "in_progress", 
    name: "Test Status", 
    labelType: OUTLINE, 
    labelVisible: true, 
    labelColor: "5b325c") {
    result
    errors {
      message
    }
  }
}

The response for the createIdeaStatus mutation looks like this:

Create Idea Status Response

{
  "data": {
    "createIdeaStatus": {
      "result": true,
      "errors": null
    }
  }
}