Skip to main content
The StopWatch API can only be used by our 💫 Unlimited subscribers. Review all subscription options here.
The StopWatch API acts as a secure proxy for specific HubSpot CRM Objects and Properties APIs, relevant to the StopWatch for HubSpot app. It is specifically designed to allow programmatic read-only access to StopWatch Time Logs record, bypassing the scope restrictions imposed by HubSpot on App Objects.

Secure Auth

Industry-standard Bearer token authentication with hashed storage.

Smart Pagination

Automatic rewriting of HubSpot pagination links for intuitive paging.

Header Forwarding

Critical HubSpot metadata (like rate limits) is passed directly to your app.

Fully Versioned

Built for long-term stability with versioned endpoints.

​
Why use the StopWatch API?

HubSpot restricts the programmatic access to App Object records to the developer providing the given app. This means that while our customers can see their StopWatch Time Log records in HubSpot’s UI, they cannot extract them programmatically using standard HubSpot API authentication methods. The StopWatch API provides a secure layer that uses the StopWatch App’s permissions to fetch records on your behalf, giving you the access you need to programmatically read your StopWatch Time Log records.

​
Base URL

The API’s base URL is: 
https://api.threadi.au

​
Authentication

All requests to the StopWatch API must include an Authorization header with a static bearer token. 
Authorization: Bearer hc_7f8a...your_key_here
API keys are currently generated upon special request. To request an API key, please submit a support request.

​
Key Features

When you fetch a list of StopWatch Time Log records, HubSpot . We automatically rewrite these links so you can use them directly in your next request: 
"paging": {
  "next": {
    "after": "12345",
    "link": "https://api.threadi.au/stopwatch/v1/timelogs?limit=10&after=12345"
  }
}

​
Header Forwarding

We forward all x-hubspot-* headers from the underlying HubSpot response. This allows your integration to monitor rate limits in real-time. These headers could include:
  • x-hubspot-correlation-id
  • x-hubspot-ratelimit-interval-milliseconds
  • x-hubspot-ratelimit-max
  • x-hubspot-ratelimit-remaining
  • x-hubspot-ratelimit-secondly
  • x-hubspot-ratelimit-secondly-remaining
Learn more about how to interpret these headers here.
Next, explore our API Reference to start building.