Skip to content

Create a support ticket

POST /api/v2/support/tickets

Opens a support ticket on your Hostup account. Take departmentSlug from GET /api/v2/support/departments (do not guess department slugs from the names). For a VPS, an IP address or a VPS network, use the vps department slug. The response is the new ticket.

To link a service, send context.serviceType and context.serviceId (do not send accountId at the top level). Use hosting with an acct_… ID for web hosting. Use vps with a vps_… ID and domain with a dom_… ID. The service must be on your account.

This call takes no files. Upload a file with POST /api/v2/support/attachments and put the returned url in message.

priority: "critical" sends a critical alert to the on-call engineer. It is for a Hostup service that is down on Hostup’s side. It needs a linked service in context and a criticalReason of at least 15 characters. The account must be established or verified with BankID. Otherwise the call returns 403. Each critical alert uses one prepaid critical support credit. Without a credit the call returns 402 payment_required. See your credits with GET /api/v2/support/critical-credits. You can send one critical alert per hour and five per 24 hours.

Authentication: An API key with the scope write:support. About keys and scopes

Request

Body

departmentSlugstringrequired
Department slug from GET /api/v2/support/departments. Use vps for VPS, IP address and VPS network questions.
subjectstringrequired
Ticket subject, up to 255 characters.
messagestringrequired
The first message, up to 65536 characters.
prioritystring
Ticket priority. Default low. critical sends a critical alert and has extra requirements. One of low, medium, high, urgent, critical.
ccEmailsarray of string
Up to 10 e-mail addresses to copy on the ticket.
contextobject
The service the ticket is about. Optional. The service must be on your account.
serviceTypestring
hosting for web hosting, vps, domain, or other for something without an ID. shared_hosting is a compatibility alias and is normalized to hosting. One of domain, hosting, shared_hosting, vps, other.
serviceIdstring
ID of the service: acct_… for hosting, vps_… for vps, dom_… or the domain name for domain. Not used with other.
serviceNamestring
A name for the service when serviceType is other, up to 200 characters.
aiSummarystring or null
Summary of an earlier chat with the Hostup assistant, saved with the linked service. Used by the client area.
aiHelpfulboolean or null
Whether that chat helped. Used by the client area.
criticalReasonstring or null
Required with priority: "critical". What is down and who is affected, 15 to 1000 characters.

Example

POST /api/v2/support/tickets
curl -X POST "https://cloud.hostup.se/api/v2/support/tickets" \
-H "Authorization: Bearer $HOSTUP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"departmentSlug": "domain-names",
"subject": "example.com does not resolve",
"message": "Hello, example.com stopped resolving this morning. Can you check it?",
"priority": "low",
"ccEmails": [
"ops@example.com"
],
"context": {
"serviceType": "domain",
"serviceId": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3"
}
}'

Responses

201 The new ticket.

Response 201
{
"id": "tkt_01hxa3b4c5d6e7f8g9h0j1k2m3",
"number": "10001",
"subject": "example.com does not resolve",
"body": "Hello, example.com stopped resolving this morning. Can you check it?",
"status": "open",
"priority": "low",
"departmentSlug": "domain-names",
"departmentName": "Domain names",
"createdAt": "2026-04-27T11:45:00.000Z",
"updatedAt": "2026-04-27T11:45:00.000Z",
"lastMessageAt": "2026-04-27T11:45:00.000Z",
"ccEmails": [
"ops@example.com"
],
"requesterName": "Jane Example",
"messageCount": 1,
"linkedServices": [
{
"serviceType": "domain",
"serviceId": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3",
"serviceName": "example.com",
"details": {
"status": "Active",
"autoRenew": true
}
}
],
"attachments": [],
"messages": []
}
Response fields
idstring
numberstring
The ticket number shown to the customer, usually digits. The ticket ID is id.
subjectstring or null
bodystring or null
Present only on the ticket detail and on the create response.
statusstring
One of open, answered, customer_reply, in_progress, on_hold, closed, unknown.
prioritystring
One of low, medium, high, urgent, critical.
departmentSlugstring
departmentNamestring or null
createdAtstring or null
updatedAtstring or null
lastMessageAtstring or null
ccEmailsarray of string
requesterNamestring or null
messageCountinteger
linkedServicesarray of object
serviceTypestring
serviceIdstring or null
serviceNamestring or null
detailsobject or null
attachmentsarray of object
Present only on the ticket detail and on the create response.
idstring
filenamestring or null
extensionstring or null
mimeTypestring or null
downloadUrlstring
messagesarray of object
Present only on the ticket detail and on the create response.
idstring
ticketIdstring
sentAtstring or null
bodystring or null
senderstring
One of customer, staff, automation.
senderNamestring or null
encryptedboolean
attachmentsarray of object

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400code is invalid_request. A required field is missing, a field is unknown, departmentSlug or context is invalid, or a critical alert lacks context or a long enough criticalReason. For an unknown departmentSlug the response lists the valid slugs in validDepartmentSlugs.
401Unauthorized. Authentication is required.
402code is payment_required. A critical alert needs a prepaid critical support credit and the account has none left.
403code is forbidden. A critical alert was sent from an account that is not established or verified with BankID.
404Not found. The resource does not exist or is not owned by the caller.
429code is rate_limited. You can send one critical alert per hour and five per 24 hours. Wait the number of seconds in Retry-After.
500Internal error. Retry later or contact support if the issue persists.
502Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists.