> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# WakaTime

## Overview

> [card] [Pre-built tooling](#pre-built-tooling)

> [card] [Pre-built integrations](#pre-built-integrations)

> [card] [Access requirements](#access-requirements)

> [card] [Setup guide](#setup-guide)

> [card] [Useful links](#useful-links)

> [card] [API gotchas](#api-gotchas)

## Pre-built tooling

> [accordion] ✅ Authorization
>
> | Tools | Status |
> | - | - |
> | Pre-built authorization (OAuth) | ✅ |
> | Credentials auto-refresh | ✅ |
> | Pre-built authorization UI | ✅ |
> | Custom authorization UI | ✅ |
> | Expired credentials detection | ✅ |

> [accordion] ✅ Read & write data
>
> | Tools | Status |
> | - | - |
> | Pre-built integrations | ✅ |
> | API unification | ✅ |
> | 2-way sync | ✅ |
> | Webhooks from Nango on data modifications | ✅ |
> | Real-time webhooks from 3rd-party API | 🚫 (time to contribute: \<48h) |
> | Proxy requests | ✅ |

> [accordion] ✅ Observability & data quality
>
> | Tools | Status |
> | - | - |
> | HTTP request logging | ✅ |
> | End-to-end type safety | ✅ |
> | Data runtime validation | ✅ |
> | OpenTelemetry export | ✅ |
> | Slack alerts on errors | ✅ |
> | Integration status API | ✅ |

> [accordion] ✅ Customization
>
> | Tools | Status |
> | - | - |
> | Create or customize use-cases | ✅ |
> | Pre-configured pagination | 🚫 (time to contribute: \<48h) |
> | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
> | Per-customer configurations | ✅ |

### Others

| Function name | Description | Type |
| - | - | - |
| `create-heartbeats-bulk` | Send one or more coding-activity heartbeats in a single call (up to 25 per request, per WakaTime's documented limit). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-heartbeats-bulk` | Permanently delete one or more heartbeats on a given day by their IDs. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-project` | Permanently delete a project record by its ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-all-time-since-today` | Get the total coding time logged since the account was created, up through today. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-coding-activity-digest` | Get a consolidated view of the user's coding activity: profile, recent stats, today's heartbeats, goals, and lifetime total, flagging any component still being calculated. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-current-user` | Get the authenticated WakaTime user's profile. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-leaderboard-standing` | COMPOSITE: find out where this user ranks - checks their private (team) leaderboard first (the first one, or the one given by leaderboard\_id), and falls back to the public global leaderboard if they are not part of one. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-meta` | Get WakaTime infrastructure metadata, including the public IP ranges of its API, website, and worker servers. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-stats` | Get aggregate coding-activity stats (languages, editors, OSes, projects, categories) for a given range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-summaries` | Get per-day coding-activity summaries over a date range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-durations` | List individual coding-activity duration blocks for a single given day. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-external-durations` | List externally-reported duration blocks for a single day. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-goals` | List the user's coding goals (e.g. daily/weekly time targets per project or language). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-heartbeats` | List all heartbeats (individual coding-activity pings) recorded for a single given day. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-orgs` | List the WakaTime for Teams organizations this user belongs to. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-private-leaderboards` | List the private leaderboards (team/custom leaderboards) this user belongs to. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-projects` | List all projects WakaTime has recorded activity for (auto-created from heartbeats). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-public-leaderboard` | List WakaTime's public global coding leaderboard, optionally filtered by language, country, or hireable status. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `log-heartbeat-and-confirm` | COMPOSITE: Create one or more heartbeats, poll until they are confirmed visible (or a timeout is reached), and optionally delete the heartbeats and any project they created. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `daily-summaries` | Syncs per-day coding-activity summaries (grand totals plus language, project, and category breakdowns) over a rolling date window. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `goals` | Sync the user's configured coding goals. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `heartbeats` | Sync individual coding-activity heartbeats, windowed one day at a time. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `projects` | Sync all projects WakaTime has derived from the user's heartbeat history. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

> [!NOTE]
>
> Nango has a [Nango-managed OAuth app](https://nango.dev/docs/guides/auth/auth-guide.md#nango-managed-oauth-apps) you can use in development and production. Select it when you create the integration.

## Access requirements

| Pre-Requisites | Status | Comment |
| - | - | - |
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ | |

## Setup guide

*No setup guide yet.*

> [!TIP]
>
> Need help getting started? Get help in the [community](https://nango.dev/slack).

> [!NOTE]
>
> Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/wakatime.mdx)

## Useful links

* [Web API docs (their REST API)](https://wakatime.com/developers)
* [Web API docs (their REST API)](https://wakatime.com/developers#authentication)

> [!NOTE]
>
> Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/wakatime.mdx)

## API gotchas

* Access tokens expire after 60 days but can be refreshed with the `refresh_token`.

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/wakatime.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.