Skip to main content
To create a ticket, send a POST request to /tickets with the required X-Qminder-API-Version header: 
curl -X POST https://api.qminder.com/tickets \
  -H "X-Qminder-REST-API-Key: YOUR_API_KEY" \
  -H "X-Qminder-API-Version: 2020-09-01" \
  -H "Content-Type: application/json" \
  -d '{
    "lineId": "12345",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "+12125551234",
    "email": "john@example.com"
  }'
Required fields:
  • lineId - ID of the line to create the ticket in
  • firstName - Visitor’s first name (2-50 characters)
Optional fields:
  • lastName - Visitor’s last name (max 50 characters)
  • phoneNumber - Phone number with optional + prefix (5-20 digits)
  • email - Visitor’s email address (max 100 characters)
  • languageCode - Language code, e.g. “en”, “es” (2-5 characters, default: “en”)
  • source - MANUAL, NAME, or MICROSITE (default: MANUAL)
  • fields - Array of custom input fields with inputFieldId (UUID) and value (max 500 characters) or optionIds
  • labels - Array of labels with value
Response (201 Created): 
{
  "id": "226859",
  "publicId": "A-42"
}

​
Input Fields

To use the fields parameter, you first need to discover the available input field IDs for the location. See the Input Fields query for details.

​
Error Responses

StatusDescriptionExample
400Validation failed{"statusCode": 400, "message": "First name must not be empty or blank"}
404Line, input fields, or language not found{"message": "Line with id 123456 not found"}
409Target line is disabled or archived{"message": "Line with id 789 is disabled"}