Create a feature request

curl --request POST \
  --url https://{your-subdomain}.neetoengage.com/api/external/v1/feature_requests \
  --header 'Accept: <accept>' \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "feature_request": {
    "title": "Export roadmap as CSV",
    "description": "Let admins download the roadmap as a CSV file."
  },
  "reference_note": {
    "body": "<p>Raised on a support call. See conversation 4821.</p>",
    "author_email": "oliver@example.com"
  },
  "customer": {
    "email": "sam@example.com",
    "name": "Sam Smith"
  },
  "operation_key": "support-ticket-4821-create"
}
'

const options = {
  method: 'POST',
  headers: {
    'X-Api-Key': '<x-api-key>',
    Accept: '<accept>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    feature_request: {
      title: 'Export roadmap as CSV',
      description: 'Let admins download the roadmap as a CSV file.'
    },
    reference_note: {
      body: JSON.stringify('<p>Raised on a support call. See conversation 4821.</p>'),
      author_email: 'oliver@example.com'
    },
    customer: {email: 'sam@example.com', name: 'Sam Smith'},
    operation_key: 'support-ticket-4821-create'
  })
};

fetch('https://{your-subdomain}.neetoengage.com/api/external/v1/feature_requests', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{your-subdomain}.neetoengage.com/api/external/v1/feature_requests"

payload = {
    "feature_request": {
        "title": "Export roadmap as CSV",
        "description": "Let admins download the roadmap as a CSV file."
    },
    "reference_note": {
        "body": "<p>Raised on a support call. See conversation 4821.</p>",
        "author_email": "oliver@example.com"
    },
    "customer": {
        "email": "sam@example.com",
        "name": "Sam Smith"
    },
    "operation_key": "support-ticket-4821-create"
}
headers = {
    "X-Api-Key": "<x-api-key>",
    "Accept": "<accept>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "feature_request": {
    "id": "5f0f3c2e-8d1b-4c53-9a6e-2b7d41c9e8a1",
    "title": "Export roadmap as CSV",
    "url": "https://spinkart.neetoengage.com/feature-requests/120-export-roadmap-as-csv",
    "admin_url": "https://spinkart.neetoengage.com/admin/feature-requests/120-export-roadmap-as-csv",
    "status": null,
    "track": "Backlog",
    "votes_count": 1,
    "created_at": "2026-03-02T10:15:30Z",
    "tag_number": 120
  }
}

{
  "error": "Could not authenticate, invalid API Key"
}

{
  "error": "Title can't be blank"
}

POST

feature_requests

Create a feature request

curl --request POST \
  --url https://{your-subdomain}.neetoengage.com/api/external/v1/feature_requests \
  --header 'Accept: <accept>' \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "feature_request": {
    "title": "Export roadmap as CSV",
    "description": "Let admins download the roadmap as a CSV file."
  },
  "reference_note": {
    "body": "<p>Raised on a support call. See conversation 4821.</p>",
    "author_email": "oliver@example.com"
  },
  "customer": {
    "email": "sam@example.com",
    "name": "Sam Smith"
  },
  "operation_key": "support-ticket-4821-create"
}
'

const options = {
  method: 'POST',
  headers: {
    'X-Api-Key': '<x-api-key>',
    Accept: '<accept>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    feature_request: {
      title: 'Export roadmap as CSV',
      description: 'Let admins download the roadmap as a CSV file.'
    },
    reference_note: {
      body: JSON.stringify('<p>Raised on a support call. See conversation 4821.</p>'),
      author_email: 'oliver@example.com'
    },
    customer: {email: 'sam@example.com', name: 'Sam Smith'},
    operation_key: 'support-ticket-4821-create'
  })
};

fetch('https://{your-subdomain}.neetoengage.com/api/external/v1/feature_requests', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{your-subdomain}.neetoengage.com/api/external/v1/feature_requests"

payload = {
    "feature_request": {
        "title": "Export roadmap as CSV",
        "description": "Let admins download the roadmap as a CSV file."
    },
    "reference_note": {
        "body": "<p>Raised on a support call. See conversation 4821.</p>",
        "author_email": "oliver@example.com"
    },
    "customer": {
        "email": "sam@example.com",
        "name": "Sam Smith"
    },
    "operation_key": "support-ticket-4821-create"
}
headers = {
    "X-Api-Key": "<x-api-key>",
    "Accept": "<accept>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "feature_request": {
    "id": "5f0f3c2e-8d1b-4c53-9a6e-2b7d41c9e8a1",
    "title": "Export roadmap as CSV",
    "url": "https://spinkart.neetoengage.com/feature-requests/120-export-roadmap-as-csv",
    "admin_url": "https://spinkart.neetoengage.com/admin/feature-requests/120-export-roadmap-as-csv",
    "status": null,
    "track": "Backlog",
    "votes_count": 1,
    "created_at": "2026-03-02T10:15:30Z",
    "tag_number": 120
  }
}

{
  "error": "Could not authenticate, invalid API Key"
}

{
  "error": "Title can't be blank"
}

Replace {your-subdomain} with your workspace’s subdomain.
Learn how to find your subdomain in Workspace subdomain.

Headers

X-Api-Key

string

required

API key. Refer to Authentication for more information.

enum<string>

default:application/json

required

Must be application/json.

Available options:

application/json

Body

application/json

feature_request

object

required

Hide child attributes

feature_request.title

string

required

Title of the feature request. Public on the roadmap.

Example:

"Export roadmap as CSV"

feature_request.description

string

Description of the feature request. Public on the roadmap.

Example:

"Let admins download the roadmap as a CSV file."

reference_note

object

required

A private note for the team. Customers never see it.

Hide child attributes

reference_note.body

string

required

Body of the note. HTML is accepted.

Example:

"<p>Raised on a support call. See conversation 4821.</p>"

reference_note.author_email

string<email>

Email of the team member the note is attributed to. If it does not match a team member, the note is attributed to the workspace's oldest team member.

Example:

"oliver@example.com"

customer

object

The customer who asked for the feature. The customer is found by email, or created if they do not exist, and is recorded as a voter.

Hide child attributes

customer.email

string<email>

Email address of the customer. Matched case-insensitively.

Example:

"sam@example.com"

customer.name

string

Full name of the customer. Used only when the customer is created.

Example:

"Sam Smith"

operation_key

string

Retry token. See Idempotency.

Example:

"support-ticket-4821-create"

Response

The feature request was created.

feature_request

object

Hide child attributes

feature_request.id

string<uuid>

Unique identifier of the feature request.

Example:

"5f0f3c2e-8d1b-4c53-9a6e-2b7d41c9e8a1"

feature_request.title

string

Title of the feature request. Public on the roadmap.

Example:

"Export roadmap as CSV"

feature_request.url

string

Public URL of the feature request on the roadmap.

Example:

"https://spinkart.neetoengage.com/feature-requests/120-export-roadmap-as-csv"

feature_request.admin_url

string

URL of the feature request in the NeetoEngage admin panel.

Example:

"https://spinkart.neetoengage.com/admin/feature-requests/120-export-roadmap-as-csv"

feature_request.status

string | null

Name of the public roadmap lane the feature request is shown in. null when the feature request's track does not map to a public lane.

Example:

"Under consideration"

feature_request.track

string | null

Name of the track the feature request is on.

Example:

"Backlog"

feature_request.votes_count

integer

Number of votes on the feature request.

Example:

1

feature_request.created_at

string<date-time>

Time the feature request was created.

Example:

"2026-03-02T10:15:30Z"

feature_request.tag_number

integer

Number of the feature request, used as the prefix of its slug.

Example:

120

Getting started

Feature requests

Votes

Tracks

Changelogs

Settings

Create a feature request

Headers

Body

Response