HubstaffDeveloper Portal

Errors

API error codes and troubleshooting guide

Recent changes (1)
  1. Breaking change

    Public API available on all plans

    The Public API is no longer restricted by plan, and the error code for plan-restricted features changed from 10005 to 10006.

    Plan requirement
    Was: Organization-scoped endpoints required a Team or Enterprise plan, for organizations subject to the restrictionNow: No plan requirement
    Organization access tokens
    Was: Could not be created on a plan without API access, for the same organizationsNow: Can be created on any plan
    Error code 10005 (plan_restricted)
    Was: Returned when the plan did not include API accessNow: Retired; no longer returned
    Error code 10006 (feature_not_available)
    Was: Returned by other feature checksNow: Also returned by screenshot settings, app & URL tracking settings and overtime policies

    Organization-scoped endpoints and organization access tokens no longer check the organization’s plan, so requests that previously failed with 403 plan_restricted now succeed. The restriction never applied to every account — organizations that predated it kept access regardless of plan — so you may see no change. Rate limits are unchanged.

    Three endpoints still require the plan to include the underlying feature — screenshot settings, app & URL tracking settings, and overtime policies. They now answer 403 with code: "feature_not_available" and error_code: 10006 instead of code: "plan_restricted" and error_code: 10005. If your integration branches on 10005 or on plan_restricted, update it to 10006 / feature_not_available. Code 10005 is retired and will not be reused.

List all error codes

GET/v2/error_codes

Returns all available error codes with their descriptions. Use these codes for programmatic error handling and i18n support.

Error code ranges:

  • 10000-10999: Authentication & Authorization
  • 11000-11999: Validation
  • 12000-12999: Resource
  • 13000-13999: Rate Limiting
  • 14000-14999: Time Entries / Activities
  • 15000-15999: System

Responses

200List of error codes