Ideas API

Create an idea with custom fields

POST /api/v1/products/:product_id/ideas

Parameters
NameDescription
product_id *

Numeric ID or key of the product

submitted_idea_portal_id

Numeric ID of the ideas portal

name

Name of the idea

description

Description of the idea — may include HTML formatting.

workflow_status

Status of the idea — must be a valid status for the selected product.

tags

Tags can be automatically assigned to the new idea. If more than one tag is used then tags should be separated by commas.

categories

Names of the existing categories the idea should be assigned to. If more than one category is used then categories should be separated by commas.

created_by *

Email address of user who created the idea — does not need to be an Aha! user email.

assigned_to_user

Email address of user that is assigned the idea.

feature

Feature ID of the feature that the idea was promoted to

initiative

Initiative ID of the initiative that the idea was promoted to

epic

Epic ID of the epic that the idea was promoted to

duplicate_idea

Idea ID for an idea which this idea duplicates. Setting this value will merge this idea into the provided idea ID; setting it to a null or blank value will unmerge this idea

initial_votes

Number of votes to seed the vote count with when importing from other systems

visibility

Initial visibility of the idea (aha, creator, employee, employee_or_creator, or public - aha is the default)

created_at

Date of idea creation. In UTC timezone with format YYYY-MM-DD or YYYY-MM-DD HH:MM:SS.

spam

Whether the idea is considered spam. Must be 'true' or 'false'

Example request

POST /api/v1/products/PRJ1/ideas

Example CURL command

curl "https://company.aha.io/api/v1/products/PRJ1/ideas" -d '{"idea":{"name":"New idea","custom_fields":{"priority":"P3"}}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
contentType: application/json
accept: application/json

Request body

Response

Status: 200 OK
contentType: application/json; charset=utf-8

Response body