Create an Ideas Board

Create a new Idea board using the GraphQL API.

An Idea Board is where members of your community can receive and manage suggestions and other ideas from your community about your products and/or services. You can create one using the GraphQL API.

Only administrators can create Idea Boards.

Requirements

For creating the Idea Board, you must have the Create boards permission set to Grant by the Administrator.

Example

As an administrator, you can use a mutation to create a new Idea Board. The createBoard mutation is all we need.

Inside the mutation, you'll set the board's id, define its conversationStyle as IDEA to let Aurora know you're creating an Idea Board, and give the board a title and optional description.

mutation {
  createBoard(
    createInput: {
      id: "board:idea01"
      conversationStyle: IDEA
      title: "Idea Board 1"
      description: "This is the board description."
    }
  ) {
    result {
      id
      title
      description
      depth
      displayId
      conversationStyle
    }
  }
}

We also requested the new board's information to be returned as a result. You can see an example result below:

{
  "data": {
    "createBoard": {
      "result": {
        "id": "board:idea01",
        "title": "Idea Board 1",
        "description": "This is the board description.",
        "depth": 1,
        "displayId": "idea01",
        "conversationStyle": "IDEA"
      }
    }
  }
}