Hubstaff Time Tracking API

Overview

Hubstaff Time Tracking API enables developers to integrate Hubstaff's advanced time tracking and GPS functionality into their applications. The API continues to evolve with more endpoints and capabilities for comprehensive workforce management.

Core API Features

Time Tracking

• Start and stop timers programmatically
• Create manual time entries
• Retrieve time tracking data
• Update and delete time entries
• Access screenshots and activity levels

Organization Management

• Manage organizations and teams
• User account creation and updates
• Project and task management
• Client management
• Location tracking data

GPS & Location Services

• Access GPS tracking data
• Retrieve location history
• Geofencing information
• Route tracking and playback

Reporting & Analytics

• Time and activity reports
• Project cost reports
• Productivity metrics
• Custom report generation
• Data exports

Authentication

• OAuth 2.0 authentication
• Personal access tokens
• Organization-level permissions
• Scoped access control

API Endpoints

Organizations

• GET /v2/organizations
• GET /v2/organizations/
• GET /v2/organizations//members

Time Tracking

• POST /v2/organizations//activities/start
• POST /v2/organizations//activities/stop
• GET /v2/organizations//activities
• POST /v2/organizations//activities/manual

Projects

• GET /v2/organizations//projects
• POST /v2/organizations//projects
• PUT /v2/organizations//projects/

Screenshots & Activity

• GET /v2/organizations//screenshots
• GET /v2/organizations//activities/apps
• GET /v2/organizations//activities/urls

GPS Tracking

• GET /v2/organizations//locations
• GET /v2/organizations//routes

Webhooks

Real-time notifications for:

• Time tracking events (start, stop, manual entry)
• User status changes
• Project updates
• Screenshot captures
• GPS location updates

Rate Limiting

• Varies by plan level
• Rate limit headers included in responses
• Retry-After header for throttled requests
• Best practice: implement exponential backoff

Use Cases

Integration Scenarios

1. Payroll Systems: Automated timesheet export
2. Project Management: Sync time data with PM tools
3. Invoicing: Generate client invoices from tracked time
4. HR Systems: Employee productivity analytics
5. Custom Dashboards: Build specialized reporting interfaces
6. Mobile Apps: Create custom time tracking experiences

Workforce Management

• Field service dispatch integration
• Employee monitoring dashboards
• Custom geofencing applications
• Productivity tracking systems
• Client billing automation

SDK Support

Official and community libraries:

• JavaScript/Node.js
• Python
• PHP
• Ruby
• .NET/C#

Advanced Features

Activity Monitoring

• Application usage tracking
• URL visit tracking
• Activity level percentages
• Idle time detection

Screenshot API

• Retrieve screenshot images
• Screenshot settings management
• Blur sensitive information
• Screenshot frequency control

GPS Features

• Real-time location tracking
• Historical route playback
• Geofence management
• Distance calculations
• Location-based reporting

Data Format

JSON responses with consistent structure:

{
  "time_entries": [
    {
      "id": 123456,
      "user_id": 789,
      "project_id": 456,
      "starts_at": "2026-03-16T09:00:00Z",
      "stops_at": "2026-03-16T17:00:00Z",
      "tracked": 28800
    }
  ]
}

Documentation

• Interactive API reference
• Authentication guides
• Code examples
• Webhook setup instructions
• Changelog and version history

Security

• HTTPS encryption required
• OAuth 2.0 for secure authentication
• Granular permission scopes
• API key rotation
• Activity audit logs

Enterprise API Features

• Dedicated API endpoints
• Higher rate limits
• Priority support
• Custom webhook limits
• SLA guarantees
• Dedicated account management