BizKitHub
DocsAPI ReferenceIssue/bff/issue/support-create
postIssueAdmin BFF

/bff/issue/support-create

Files an internal support ticket against BizKitHub on behalf of the authenticated organisation. The issue is created inside BizKitHubs SUPPORT project but the originating organisation can also see and comment on it via /detail, /comments and /add-comment or /add-email. A confirmation email is sent automatically (existing issue notification flow), and any subsequent comment from BizKitHub is delivered back to the reporters mailbox.

IssuepostBffIssueSupport-create

Parameters

JSON body

Request body

application/json
subjectstringOptional

Optional subject/title. The admin "Napsat podpoře" modal omits it: the server derives a stand-in from the first line of description (flagged subject_is_placeholder) and the AI triage pass writes a proper subject within seconds.

Length: 0–200
ExampleCannot connect TTLock device to gateway
descriptionstringOptional

Detailed description of the issue (Markdown or HTML). Required in practice when subject is omitted; the server rejects a ticket with neither.

Length: 0–50000
Example<p>The device shows blue blinking after pairing but never reaches the cloud.</p>
pageUrlstringOptional

Admin page URL the reporter was on when they opened the modal. Stored in pm__issue.reporter_page_url (http(s) only, fragment dropped) so the support team sees where the problem happened without asking.

Length: 0–2000
Examplehttps://admin.bizkithub.com/invoice/2026-0042
urgentbooleanOptional

Reporter's felt-urgency flag. true when the person filing the ticket explicitly ticked an 'urgent for me' checkbox. Persisted to pm__issue.user_urgency_hint (orthogonal to priority — the AI triage classifier owns priority) and passed as a soft input to the classifier. Never authoritative on its own: content still decides the final priority.

Default: false

Response schema

1 status code documented

200Success
successbooleanRequired

Whether the support ticket was created successfully.

issueKeystringRequired

Generated ticket key.

ExampleBIZKIT-42
internalIdnumberRequired

Internal numeric ID.

Response example

application/json
{
  "success": false,
  "issueKey": "BIZKIT-42",
  "internalId": 0
}

Request example

POST /bff/issue/support-create

post
curl -X POST "https://api.bizkithub.com/bff/issue/support-create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "subject": "Cannot connect TTLock device to gateway",
  "description": "<p>The device shows blue blinking after pairing but never reaches the cloud.</p>",
  "pageUrl": "https://admin.bizkithub.com/invoice/2026-0042",
  "urgent": false
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key