FoxDesk
Start free trial
Open navigation

Tickets, time tracking, and an agent API

See the ticket, reporting, email, and API functions included in FoxDesk.

FoxDesk combines a customer-support ticket with its replies, files, time entries, organization, and reporting data.

Ticket workflow

Agents create tickets in the application. Customers can use the portal, and configured mailboxes can turn incoming email into tickets or replies.

  • Assignment and priority: Assign an owner, status, type, priority, organization, and tags.
  • Public and internal replies: Keep customer-visible messages and internal notes in the same activity history.
  • Email intake: Fetch messages from a configured IMAP mailbox on a schedule.
  • Concurrent viewing: Show agents when another user is viewing the same ticket.
  • Attachments and rich text: Add formatted replies and files from the ticket editor.
FoxDesk ticket detail

Time tracking and reports

Start a timer from a ticket or enter a duration manually. Time entries retain the user, ticket, client, organization, date, billing status, and summary.

  • Timer controls: Start, pause, resume, stop, or cancel a running timer.
  • Manual entries: Record work that was completed without a timer.
  • Rates: Store billable and internal cost rates for reporting.
  • Exports and sharing: Export reports and create shareable report links.
FoxDesk time report

Agent API

Create a separate agent account and scoped Bearer token for an external script or AI agent. API actions are checked against that account’s permissions.

  • agent-create-ticket: Create a ticket.
  • agent-add-update: Add a public reply or internal note.
  • agent-add-work-entry: Add a linked update and time entry atomically.
  • agent-log-time: Add a standalone time entry.
  • agent-list-tickets: Search tickets visible to the token owner.
FOXDESK_BASE_URL=https://helpdesk.example.com
FOXDESK_API_TOKEN=fdx_replace_with_token_from_settings

curl -fsS -X POST \
  "$FOXDESK_BASE_URL/index.php?page=api&action=agent-add-update" \
  -H "Authorization: Bearer $FOXDESK_API_TOKEN" \
  -H "Idempotency-Key: comment-ticket-542-20260729-01" \
  -H "Content-Type: application/json" \
  --data '{
    "ticket_id": 542,
    "content": "The nightly backup completed successfully.",
    "is_internal": true
  }'

Languages

The application includes 24 locale catalogs. Each release channel tracks translation review separately; beta translations are identified as beta.

Light and dark themes

Users can choose a light or dark theme.

Client organizations

Group clients, tickets, time entries, rates, reports, and permissions by organization.

Recurring tickets

Create tickets from a saved template on a daily, weekly, monthly, or yearly schedule.

Branding

Upload an application logo and user avatars.

Email templates

Edit the customer-facing subject and body of notification templates.

Reports

Filter time entries and ticket activity, then export or share the result.

Ticket board

View tickets as a list or board and update their status.

Progressive web app

Supported browsers can install FoxDesk as a progressive web app.

Timer controls

Active timers remain available while the user moves between pages.

Audit and activity records

Administrators can review recorded application activity and audit events.

Permissions

Roles and organization access determine which tickets and customer data a user can see.

Review before installing

Check the server requirements and release notes, then inspect the source or download the current release.