Create Ticket API

Create support tickets for user inquiries, issues, and feature requests

Support

Create Ticket API

Create support tickets to track user inquiries, technical issues, and feature requests. Organize and manage customer support efficiently.

Submit Issues

Create tickets for any support need.

Categorize

Organize by category and priority.

Track Status

Monitor ticket progress.


Endpoint Overview

MUTATION/graphql

Create a new support ticket with subject, description, and category. Tickets are tracked through the support system until resolution.

Authentication:Bearer Token

Request Parameters

ticket.subjectString!Required

Brief summary of the issue or inquiry.

ticket.textString!Required

Detailed description of the issue.

ticket.categoryString!Required

Category for the ticket (e.g., "technical", "billing", "account").

ticket.priorityString

Ticket priority level (low, medium, high, urgent).

ticket.attachments[String]

URLs to attached files or screenshots.


GraphQL Mutation

mutation createTicket($ticket: TicketCreate!) {
  createTicket(ticket: $ticket) {
    id
    subject
    text
    category
    status
    priority
    createdAt
  }
}

Variables:

{
  "ticket": {
    "subject": "Unable to connect to VPN server",
    "text": "I've been trying to connect to the US West server but keep getting a timeout error. I've tried restarting the app and my device.",
    "category": "technical",
    "priority": "high"
  }
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "query": "mutation createTicket($ticket: TicketCreate!) { createTicket(ticket: $ticket) { id subject status createdAt } }",
    "variables": {
      "ticket": {
        "subject": "Unable to connect to VPN server",
        "text": "Connection timeout on US West server",
        "category": "technical"
      }
    }
  }'

Response

200Ticket Created Successfully
{
  "data": {
    "createTicket": {
      "id": "ticket_12345",
      "subject": "Unable to connect to VPN server",
      "text": "I've been trying to connect to the US West server...",
      "category": "technical",
      "status": "open",
      "priority": "high",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  }
}
400Invalid Category
{
  "errors": [
    {
      "message": "Invalid ticket category",
      "path": ["createTicket"],
      "extensions": {
        "code": "INVALID_CATEGORY"
      }
    }
  ],
  "data": null
}

Ticket Categories

Technical

Connection issues, app problems, errors.

Billing

Payment, subscription, refund inquiries.

Account

Login, password, profile issues.

Feature Request

Suggestions and enhancement requests.


Best Practices

Clear Subject

Write concise, descriptive subjects.

Detail Issue

Include steps to reproduce problems.

Correct Category

Select appropriate category for routing.

Attach Evidence

Include screenshots or logs when helpful.



Ticket Tracking

After creation, you'll receive a ticket ID to track your issue. Check the ticket status anytime using the Get Ticket API.

Track Your Tickets

View all your submitted tickets and their current status.

View My Tickets