BizKitHub
DocsAPI ReferenceIssue/bff/issue/create
postIssueAdmin BFF

/bff/issue/create

Creates a new issue in the default project. The AI workflow is triggered automatically to classify and process the issue.

IssuepostBffIssueCreate

Parameters

JSON body

Request body

application/json
subjectstringRequired

Issue subject/title.

Length: 1
ExampleLogin page returns 500 error
descriptionstringOptional

Issue description (supports HTML).

internalDescriptionstringOptional

Internal notes visible only to team members.

prioritynumberOptional

Priority: 1=low, 2=normal, 3=high, 4=critical, 5=blocker.

Range: 15Default: 2
assigneeContactIdnumberOptional

Assignee contact ID.

Example10
reporterContactIdnumberOptional

Reporter contact ID.

Example5
parentIssueKeystringOptional

Parent issue key for sub-tasks (e.g. "PROJ-100").

ExamplePROJ-100
issueTypeCodestringOptional

Issue type slug from pm__issue_type.code (story, epic, task, sub_task, bug, incident, feature_request, change_request, question, service_request). Defaults to story.

Examplesstorybug

Response schema

1 status code documented

200Success
successbooleanRequired

Whether the issue was created successfully.

issueKeystringRequired

Generated issue key.

ExamplePROJ-124
internalIdnumberRequired

Internal numeric ID.

Response example

application/json
{
  "success": false,
  "issueKey": "PROJ-124",
  "internalId": 0
}

Request example

POST /bff/issue/create

post
curl -X POST "https://api.bizkithub.com/bff/issue/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "subject": "Login page returns 500 error",
  "description": "example_description",
  "internalDescription": "example_internalDescription",
  "priority": 2,
  "assigneeContactId": 10,
  "reporterContactId": 5,
  "parentIssueKey": "PROJ-100",
  "issueTypeCode": "story"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key