POST api/v2.0/Ideation/Post

Create a new idea.

Request Information

URI Parameters

None.

Body Parameters

New idea to submit

Name	Description	Type	Additional information
Title	Title of the idea. Maximum length is 100 characters.	string	Required
Description	Description of the idea.	string	Required
IdeationStatusKey	Key for the status of the idea. Statuses are configurable on a per-site basis, the list of available statuses can be retrieved from the getStatuses endpoint.	globally unique identifier	Required
IdeationCategoryKeys	Keys for the categories the idea is associated to. Categories are configurable on a per-site basis, the list of available categories can be retrieved from the getCategories endpoint.	Collection of globally unique identifier	None.
IsAnonymous	True if the idea is being submitted anonymously.	boolean	None.

Request Formats

application/json, text/json

Sample:

{
  "Title": "sample string 1",
  "Description": "sample string 2",
  "IdeationStatusKey": "dd714865-0c74-4d65-a186-6c3f5ec9b956",
  "IdeationCategoryKeys": [
    "c07d52b3-976e-4205-9eb9-92945514b579",
    "fd9e9c88-d40b-44d3-a2dc-38366881b377"
  ],
  "IsAnonymous": true
}

application/xml, text/xml

Sample:

<NewIdeaRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Ideation">
  <Description>sample string 2</Description>
  <IdeationCategoryKeys xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>c07d52b3-976e-4205-9eb9-92945514b579</d2p1:guid>
    <d2p1:guid>fd9e9c88-d40b-44d3-a2dc-38366881b377</d2p1:guid>
  </IdeationCategoryKeys>
  <IdeationStatusKey>dd714865-0c74-4d65-a186-6c3f5ec9b956</IdeationStatusKey>
  <IsAnonymous>true</IsAnonymous>
  <Title>sample string 1</Title>
</NewIdeaRequest>

Response Information

Resource Description

Submitted idea

IdeaDetails

Name	Description	Type	Additional information
IdeationKey	Unique identifier of the idea.	globally unique identifier	None.
Title	Title of the idea.	string	None.
Description	Description of the idea.	string	None.
LinkToViewIdea	Direct link to view the idea on the main microsite.	string	None.
Status	Object containing information about the status of the idea.	IdeaStatus	None.
Community	The community the idea has been associated to. If null or doesn't exist (i.e. the idea is not associated to any community), the idea is considered to be a site-wide idea.	Community	None.
Categories	All categories the idea has been associated to.	Collection of IdeaCategory	None.
TotalUpvotes	Number of upvotes.	integer	None.
TotalDownvotes	Number of downvotes.	integer	None.
HasOfficialComment	True if this idea has an official comment from an admin.	boolean	None.
Author	Information about the author of the idea.	ContactConcise	None.
IsAnonymous	True if the idea was submitted anonymously.	boolean	None.
CreatedOn	DateTime the idea was created.	date	None.
UpdatedOn	Most recent DateTime the idea was updated.	date	None.
AttachmentURLs	Temporary URLs to view or download any attachments associated with the idea.	Collection of IdeaAttachment	None.

Response Formats

application/json, text/json

Sample:

{
  "IdeationKey": "32ebf3f6-bf8f-4ded-90a9-4958e3c9bf4b",
  "Title": "sample string 2",
  "Description": "sample string 3",
  "LinkToViewIdea": "sample string 4",
  "Status": null,
  "Community": null,
  "Categories": null,
  "TotalUpvotes": 5,
  "TotalDownvotes": 6,
  "HasOfficialComment": true,
  "Author": {
    "LinkToProfile": "sample string 1",
    "PictureUrl": "sample string 2",
    "ContactKey": "0be0fe0a-052d-4951-b6e5-047d2dc9abb6",
    "FirstName": "sample string 4",
    "LastName": "sample string 5",
    "DisplayName": "sample string 6",
    "EmailAddress": "sample string 7",
    "ContactStatusCode": "sample string 8",
    "PrefixCode": "sample string 9",
    "UpdatedOn": "2025-03-17T22:11:40.791408Z",
    "UpdatedByContactKey": "d9408fc5-7a5d-4ee4-b41e-56273450ef2e",
    "CompanyName": "sample string 12",
    "CompanyTitle": "sample string 13",
    "SuffixCode": "sample string 14",
    "Designation": "sample string 15",
    "LegacyContactKey": "sample string 16",
    "InformalName": "sample string 17",
    "MiddleName": "sample string 18",
    "IsCompany": true,
    "CompanyLegacyContactKey": "sample string 20",
    "AMSDirectoryOptOut": true,
    "HLDirectoryOptOut": true,
    "HLContactMeOptOut": true,
    "LargePictureUrl": "sample string 24",
    "AgreedToTermsDateTime": "2025-03-17T22:11:40.791408Z"
  },
  "IsAnonymous": true,
  "CreatedOn": "2025-03-17T22:11:40.791408Z",
  "UpdatedOn": "2025-03-17T22:11:40.791408Z",
  "AttachmentURLs": null
}

application/xml

Sample:

Sample not available.

text/xml

Sample:

Sample not available.