# RescueTime

> Read your RescueTime time tracking in workflows: activity reports, daily productivity summaries, categories, devices and calendar events, and post, mark and dismiss notifications in the RescueTime app.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/rescuetime

## Actions

### Count notifications

Count the current notifications in your RescueTime app that are read and unread.

**Inputs**: None.

**Outputs**

- `read` (number): How many are read
- `unread` (number): How many are unread

**Example output**

```json
{
  "read": 12,
  "unread": 3
}
```

### Create notification

Post a notification into your RescueTime app, with an optional body, button and tags.

**Inputs**

- Subject (`subject`, text, required): The headline shown in the notification list.
- Body (`body`, text): The longer text shown when the notification is opened.
- Button link (`cta_url`, text): The address the notification's button opens.
- Button label (`cta_text`, text): The button's label. Needs a button link.
- Tags (`tags`, list): Free-form tags for filtering and grouping notifications.

**Outputs**

- `notification` (object): The notification

**Example output**

```json
{
  "notification": {
    "content": {
      "body": "Your week in review is ready to read.",
      "cta_text": "Open dashboard",
      "cta_url": "https://www.rescuetime.com/dashboard",
      "subject": "Weekly report ready",
      "tags": [
        "report"
      ]
    },
    "created_at": "2026-10-20T09:00:00Z",
    "dismissed_at": null,
    "id": 789,
    "read_at": null
  }
}
```

### Delete notification

Delete a notification from your RescueTime app for good.

**Inputs**

- Notification (`notification_id`, text, required): The notification. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once RescueTime accepts the delete
- `notification` (object): The notification
- `notification_id` (number): The id of the deleted notification

**Example output**

```json
{
  "deleted": true,
  "notification": {
    "content": {
      "body": "Your week in review is ready to read.",
      "cta_text": "Open dashboard",
      "cta_url": "https://www.rescuetime.com/dashboard",
      "subject": "Weekly report ready",
      "tags": [
        "report"
      ]
    },
    "created_at": "2026-10-20T09:00:00Z",
    "dismissed_at": null,
    "id": 789,
    "read_at": null
  },
  "notification_id": 789
}
```

### Get account settings

Get the account's tracking settings: whether window titles are tracked and whether adult websites are filtered out.

**Inputs**: None.

**Outputs**

- `account` (object): The account's settings

**Example output**

```json
{
  "account": {
    "created_at": "2020-01-15T10:30:00Z",
    "global_ignore_entity_kind_adult": false,
    "id": 456,
    "window_titles_enabled": true
  }
}
```

### Get activity report

Get time spent per app, website, category or productivity level for a date range, ranked or over time. Each row comes back as a record keyed by the report's column names.

**Inputs**

- Perspective (`perspective`, text): Ranked by time spent (one row per item, the default), or over time (one row per item per period). One of: `rank` (Ranked by time spent), `interval` (Over time).
- Resolution (`resolution_time`, text): The period each row covers when the perspective is over time. RescueTime's default is hour. One of: `month`, `week`, `day`, `hour`, `minute` (5 minutes).
- From date (`restrict_begin`, date): The first day to include. On the free Lite plan, reports cover the last 2 weeks only.
- To date (`restrict_end`, date): The last day to include.
- Group by (`restrict_kind`, text): What each row is: an overview, category, activity (app or website), productivity level, document or efficiency. Documents need a paid plan; efficiency needs the over time perspective. One of: `overview` (Overview (top-level categories)), `category`, `activity` (Activity (apps and websites)), `productivity` (Productivity level), `document` (Document (paid plans only)), `efficiency` (Efficiency (over time only)).
- Only this item (`restrict_thing`, text): Limit the report to one overview, category, app or website by name. For a website use the domain without www, such as nytimes.com.
- Only this document (`restrict_thingy`, text): Limit the report to one document or page within the item, such as a file name. Needs a paid plan's detailed tracking.
- Devices (`restrict_source_type`, text): Only time from computers, mobile devices or offline entries. One of: `computers`, `mobile`, `offline` (Offline time).
- Rows (`limit`, number): How many rows to return, 1 to 5000. Leave empty for all. From 1 to 5000.
- Skip rows (`offset`, number): How many rows to skip first, to read a report in pages. At least 0.

**Outputs**

- `count` (number): How many records this step returned
- `notes` (text): RescueTime's note on what the report holds
- `records` (list): The report's rows as records
- `row_headers` (list): The report's column names, in row order
- `rows` (list): The report's rows as RescueTime sends them
- `total_rows` (number): How many rows the whole report has

**Example output**

```json
{
  "count": 1,
  "notes": "data is an array of arrays (rows), column names for rows in row_headers",
  "records": [
    {
      "Activity": "Visual Studio Code",
      "Category": "Editing & IDEs",
      "Number of People": 1,
      "Productivity": 2,
      "Rank": 1,
      "Time Spent (seconds)": 5400
    }
  ],
  "row_headers": [
    "Rank",
    "Time Spent (seconds)",
    "Number of People",
    "Activity",
    "Category",
    "Productivity"
  ],
  "rows": [
    [
      1,
      5400,
      1,
      "Visual Studio Code",
      "Editing & IDEs",
      2
    ]
  ],
  "total_rows": 1
}
```

### Get current user

Get the RescueTime user the API key belongs to: name, email, time zone and first day of the week.

**Inputs**: None.

**Outputs**

- `user` (object): The RescueTime user the API key belongs to

**Example output**

```json
{
  "user": {
    "created_at": "2020-01-15T10:30:00Z",
    "display_name": "Jo Bloggs",
    "email": "jo@example.com",
    "id": 123,
    "time_zone": "America/Los_Angeles",
    "week_start_day": 0
  }
}
```

### Get overview tree

Get every overview with its categories and activities, with your own productivity scores applied.

**Inputs**: None.

**Outputs**

- `tree` (object): Overviews, their categories and activities, as RescueTime nests them

**Example output**

```json
{
  "tree": {
    "Business": {
      "Accounting": {
        "QuickBooks": {
          "score": 2
        }
      }
    }
  }
}
```

### List calendar events

List events from the calendar connected to RescueTime for a day or a time window, optionally only meetings. Today by default.

**Inputs**

- Day (`date`, date): A whole day in your RescueTime time zone. Leave this and the window empty for today.
- Window start (`dt_start`, date and time): The start of a time window, instead of a day.
- Window end (`dt_end`, date and time): The end of the window. Defaults to the end of the start's day.
- Meetings only (`meetings_only`, true/false): On returns only events RescueTime counts as meetings, such as those with several attendees. Default: `false`.

**Outputs**

- `count` (number): How many records this step returned
- `events` (list): The events

**Example output**

```json
{
  "count": 1,
  "events": [
    {
      "id": 55,
      "start_time": "2026-10-22T16:00:00Z",
      "summary": "Team standup"
    }
  ]
}
```

### List categories

List the categories RescueTime sorts apps and websites into, such as Accounting under Business, with their ids.

**Inputs**

- Name contains (`search`, text): Only categories whose name contains this text. Leave empty for all.

**Outputs**

- `categories` (list): The categories
- `count` (number): How many records this step returned

**Example output**

```json
{
  "categories": [
    {
      "id": 2151,
      "name": "Accounting",
      "overview": "Business"
    }
  ],
  "count": 1
}
```

### List category overrides

List the apps and websites whose category or productivity you have changed, with the app or website and category included.

**Inputs**

- Override IDs (`profile_entity_ids`, list): Only these overrides, by id. Leave empty for all of them.

**Outputs**

- `count` (number): How many records this step returned
- `overrides` (list): The overrides

**Example output**

```json
{
  "count": 1,
  "overrides": [
    {
      "category_id": 2151,
      "entity_id": 4521,
      "id": 901,
      "score": 2,
      "sub_entity_id": -1
    }
  ]
}
```

### List daily summaries

List a summary of each logged day in the last two weeks: productivity pulse, and time and share per productivity level and category. Today is not included; yesterday's arrives just after midnight.

**Inputs**: None.

**Outputs**

- `count` (number): How many records this step returned
- `summaries` (list): One per day

**Example output**

```json
{
  "count": 1,
  "summaries": [
    {
      "all_distracting_duration_formatted": "4h 12m 30s",
      "all_distracting_hours": 12.5,
      "all_distracting_percentage": 12.5,
      "all_productive_duration_formatted": "4h 12m 30s",
      "all_productive_hours": 12.5,
      "all_productive_percentage": 12.5,
      "business_duration_formatted": "4h 12m 30s",
      "business_hours": 12.5,
      "business_percentage": 12.5,
      "communication_and_scheduling_duration_formatted": "4h 12m 30s",
      "communication_and_scheduling_hours": 12.5,
      "communication_and_scheduling_percentage": 12.5,
      "date": "2026-10-22",
      "design_and_composition_duration_formatted": "4h 12m 30s",
      "design_and_composition_hours": 12.5,
      "design_and_composition_percentage": 12.5,
      "distracting_duration_formatted": "4h 12m 30s",
      "distracting_hours": 12.5,
      "distracting_percentage": 12.5,
      "entertainment_duration_formatted": "4h 12m 30s",
      "entertainment_hours": 12.5,
      "entertainment_percentage": 12.5,
      "id": 1792540800,
      "neutral_duration_formatted": "4h 12m 30s",
      "neutral_hours": 12.5,
      "neutral_percentage": 12.5,
      "news_duration_formatted": "4h 12m 30s",
      "news_hours": 12.5,
      "news_percentage": 12.5,
      "productive_duration_formatted": "4h 12m 30s",
      "productive_hours": 12.5,
      "productive_percentage": 12.5,
      "productivity_pulse": 71,
      "reference_and_learning_duration_formatted": "4h 12m 30s",
      "reference_and_learning_hours": 12.5,
      "reference_and_learning_percentage": 12.5,
      "shopping_duration_formatted": "4h 12m 30s",
      "shopping_hours": 12.5,
      "shopping_percentage": 12.5,
      "social_networking_duration_formatted": "4h 12m 30s",
      "social_networking_hours": 12.5,
      "social_networking_percentage": 12.5,
      "software_development_duration_formatted": "4h 12m 30s",
      "software_development_hours": 12.5,
      "software_development_percentage": 12.5,
      "total_duration_formatted": "4h 12m 30s",
      "total_hours": 12.5,
      "uncategorized_duration_formatted": "4h 12m 30s",
      "uncategorized_hours": 12.5,
      "uncategorized_percentage": 12.5,
      "utilities_duration_formatted": "4h 12m 30s",
      "utilities_hours": 12.5,
      "utilities_percentage": 12.5,
      "very_distracting_duration_formatted": "4h 12m 30s",
      "very_distracting_hours": 12.5,
      "very_distracting_percentage": 12.5,
      "very_productive_duration_formatted": "4h 12m 30s",
      "very_productive_hours": 12.5,
      "very_productive_percentage": 12.5
    }
  ]
}
```

### List daily summaries for dates

List daily time summaries for any date range, today included. The free Lite plan keeps the last 2 weeks.

**Inputs**

- From date (`start_date`, date, required): The first day to include.
- To date (`end_date`, date, required): The last day to include. Today works too.
- Full detail (`verbose`, true/false): On returns every figure for each day instead of the short form. Default: `false`.

**Outputs**

- `count` (number): How many records this step returned
- `summaries` (list): One per day in the range

**Example output**

```json
{
  "count": 1,
  "summaries": [
    {
      "date": "2026-10-22",
      "total_time": 15120
    }
  ]
}
```

### List devices

List the computers and phones that report to RescueTime. By default, those used in the last 90 days.

**Inputs**

- Every device (`all_devices`, true/false): On lists every device ever connected. Off lists those used in the last 90 days. Default: `false`.
- Used since (`active_since`, date and time): Only devices used at or after this time.

**Outputs**

- `count` (number): How many records this step returned
- `devices` (list): The devices

**Example output**

```json
{
  "count": 1,
  "devices": [
    {
      "id": 31,
      "name": "Jo's MacBook",
      "platform": "mac"
    }
  ]
}
```

### List notifications

List the notifications in your RescueTime app that are not dismissed or expired, optionally only read or unread ones.

**Inputs**

- Show (`read_status`, text): All current notifications, or only read or unread. One of: `all` (All current), `read`, `unread`. Default: `all`.

**Outputs**

- `count` (number): How many records this step returned
- `notifications` (list): The notifications

**Example output**

```json
{
  "count": 1,
  "notifications": [
    {
      "content": {
        "body": "Your week in review is ready to read.",
        "cta_text": "Open dashboard",
        "cta_url": "https://www.rescuetime.com/dashboard",
        "subject": "Weekly report ready",
        "tags": [
          "report"
        ]
      },
      "created_at": "2026-10-20T09:00:00Z",
      "dismissed_at": null,
      "id": 789,
      "read_at": null
    }
  ]
}
```

### List overviews

List the top-level categories, such as Business, Entertainment and Software Development. Their names filter the activity report.

**Inputs**: None.

**Outputs**

- `count` (number): How many records this step returned
- `overviews` (list): The overviews

**Example output**

```json
{
  "count": 1,
  "overviews": [
    {
      "id": 3,
      "name": "Business"
    }
  ]
}
```

### List productivity levels

List the five productivity levels with their scores, from very distracting (-2) to very productive (2).

**Inputs**: None.

**Outputs**

- `count` (number): How many records this step returned
- `productivity_levels` (list): The levels

**Example output**

```json
{
  "count": 1,
  "productivity_levels": [
    {
      "id": 5,
      "name": "very productive",
      "score": 2
    }
  ]
}
```

### Set activity category

Give an app or website your own category, productivity score, or both. RescueTime uses it for that activity from then on.

**Inputs**

- Activity ID (`entity_id`, text, required): The id of the app or website, from 'List category overrides' or 'Get overview tree'.
- Document ID (`sub_entity_id`, text): A document or page within the app, such as one site in a browser. Leave empty to change the whole app or website.
- Category (`category_id`, text): The category to put it in. Leave empty to keep it.
- Productivity (`score`, text): How productive time on it is. The app's names come first, with the API's in brackets. Leave empty to keep it. One of: `2` (Focus Work (very productive)), `1` (Other Work (productive)), `0` (Neutral), `-1` (Personal (distracting)), `-2` (Distracting (very distracting)).

**Outputs**

- `override` (object): The saved override

**Example output**

```json
{
  "override": {
    "category_id": 2151,
    "entity_id": 4521,
    "id": 901,
    "score": 2,
    "sub_entity_id": -1
  }
}
```

### Update account settings

Turn window title tracking or the adult content filter on or off. Settings left empty stay as they are.

**Inputs**

- Window title tracking (`window_titles`, text): Turn tracking of window titles (document and page names) on or off. Detailed tracking needs a paid plan. Leave empty to keep it. One of: `on`, `off`.
- Adult content filter (`adult_content_filter`, text): On leaves adult websites out of tracking. Leave empty to keep the current setting. One of: `on`, `off`.

**Outputs**

- `account` (object): The account's settings

**Example output**

```json
{
  "account": {
    "created_at": "2020-01-15T10:30:00Z",
    "global_ignore_entity_kind_adult": false,
    "id": 456,
    "window_titles_enabled": true
  }
}
```

### Update notification

Mark a notification read or unread, dismiss it, or both in one step.

**Inputs**

- Notification (`notification_id`, text, required): The notification. Pick one, or give its id from an earlier step.
- Mark as (`mark_as`, text): Mark the notification read or unread. Leave empty to keep it. One of: `read`, `unread`.
- Dismiss (`dismiss`, true/false): On dismisses the notification, which hides it from the list. Default: `false`.

**Outputs**

- `notification` (object): The notification

**Example output**

```json
{
  "notification": {
    "content": {
      "body": "Your week in review is ready to read.",
      "cta_text": "Open dashboard",
      "cta_url": "https://www.rescuetime.com/dashboard",
      "subject": "Weekly report ready",
      "tags": [
        "report"
      ]
    },
    "created_at": "2026-10-20T09:00:00Z",
    "dismissed_at": null,
    "id": 789,
    "read_at": "2026-10-22T10:00:00Z"
  }
}
```

### Update user profile

Change your display name, time zone, first day of the week, or whether RescueTime sends the weekly stats and alert emails. Fields left empty keep their values.

**Inputs**

- Display name (`display_name`, text): The name shown in RescueTime. Leave empty to keep it.
- Time zone (`time_zone`, text): A time zone name such as America/New_York or Europe/London. Leave empty to keep it.
- Week starts on (`week_start_day`, text): The first day of the week in reports. Leave empty to keep it. One of: `0` (Sunday), `1` (Monday).
- Weekly stats email (`send_stats_email`, text): Turn the weekly stats email on or off. Leave empty to keep it. One of: `on`, `off`.
- Alert emails (`alert_emails`, text): Turn alert emails on or off. Leave empty to keep it. One of: `on`, `off`.

**Outputs**

- `user` (object): The RescueTime user the API key belongs to

**Example output**

```json
{
  "user": {
    "created_at": "2020-01-15T10:30:00Z",
    "display_name": "Jo Bloggs",
    "email": "jo@example.com",
    "id": 123,
    "time_zone": "America/Los_Angeles",
    "week_start_day": 0
  }
}
```
