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
departmentSlugstringrequiredGET /api/v2/support/departments. Use vps for VPS, IP address and VPS network questions.subjectstringrequiredmessagestringrequiredprioritystringlow. critical sends a critical alert and has extra requirements. One of low, medium, high, urgent, critical.ccEmailsarray of stringcontextobjectserviceTypestringhosting 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.serviceIdstringacct_… for hosting, vps_… for vps, dom_… or the domain name for domain. Not used with other.serviceNamestringserviceType is other, up to 200 characters.aiSummarystring or nullaiHelpfulboolean or nullcriticalReasonstring or nullpriority: "critical". What is down and who is affected, 15 to 1000 characters.Example
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" } }'curl -X POST "https://cloud.hostup.se/api/v2/support/tickets" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "departmentSlug": "vps", "subject": "Manual IPv4 replacement requested", "message": "Hello, I need help replacing the IPv4 address on my VPS.", "priority": "medium", "context": { "serviceType": "vps", "serviceId": "vps_01hxa3b4c5d6e7f8g9h0j1k2m3" } }'Responses
201 The new ticket.
{ "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
idstringnumberstringid.subjectstring or nullbodystring or nullstatusstringopen, answered, customer_reply, in_progress, on_hold, closed, unknown.prioritystringlow, medium, high, urgent, critical.departmentSlugstringdepartmentNamestring or nullcreatedAtstring or nullupdatedAtstring or nulllastMessageAtstring or nullccEmailsarray of stringrequesterNamestring or nullmessageCountintegerlinkedServicesarray of objectserviceTypestringserviceIdstring or nullserviceNamestring or nulldetailsobject or nullattachmentsarray of objectidstringfilenamestring or nullextensionstring or nullmimeTypestring or nulldownloadUrlstringmessagesarray of objectidstringticketIdstringsentAtstring or nullbodystring or nullsenderstringcustomer, staff, automation.senderNamestring or nullencryptedbooleanattachmentsarray of objectErrors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | code 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. |
| 401 | Unauthorized. Authentication is required. |
| 402 | code is payment_required. A critical alert needs a prepaid critical support credit and the account has none left. |
| 403 | code is forbidden. A critical alert was sent from an account that is not established or verified with BankID. |
| 404 | Not found. The resource does not exist or is not owned by the caller. |
| 429 | code is rate_limited. You can send one critical alert per hour and five per 24 hours. Wait the number of seconds in Retry-After. |
| 500 | Internal error. Retry later or contact support if the issue persists. |
| 502 | Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists. |