RescueTime

App · 20 actions

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.

Actions

ActionWhat it does
Count notificationsCount the current notifications in your RescueTime app that are read and unread.
Create notificationPost a notification into your RescueTime app, with an optional body, button and tags.
Delete notificationDelete a notification from your RescueTime app for good.
Get account settingsGet the account's tracking settings: whether window titles are tracked and whether adult websites are filtered out.
Get activity reportGet time spent per app, website, category or productivity level for a date range, ranked or over time.
Get current userGet the RescueTime user the API key belongs to: name, email, time zone and first day of the week.
Get overview treeGet every overview with its categories and activities, with your own productivity scores applied.
List calendar eventsList events from the calendar connected to RescueTime for a day or a time window, optionally only meetings.
List categoriesList the categories RescueTime sorts apps and websites into, such as Accounting under Business, with their ids.
List category overridesList the apps and websites whose category or productivity you have changed, with the app or website and category included.
List daily summariesList a summary of each logged day in the last two weeks: productivity pulse, and time and share per productivity level and category.
List daily summaries for datesList daily time summaries for any date range, today included.
List devicesList the computers and phones that report to RescueTime.
List notificationsList the notifications in your RescueTime app that are not dismissed or expired, optionally only read or unread ones.
List overviewsList the top-level categories, such as Business, Entertainment and Software Development.
List productivity levelsList the five productivity levels with their scores, from very distracting (-2) to very productive (2).
Set activity categoryGive an app or website your own category, productivity score, or both.
Update account settingsTurn window title tracking or the adult content filter on or off.
Update notificationMark a notification read or unread, dismiss it, or both in one step.
Update user profileChange your display name, time zone, first day of the week, or whether RescueTime sends the weekly stats and alert emails.

Count notifications

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

Inputs

None.

Outputs

readnumber
How many are read
unreadnumber
How many are unread
Example output
{
  "read": 12,
  "unread": 3
}

Create notification

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

Inputs

SubjectsubjecttextRequired
The headline shown in the notification list.
Bodybodytext
The longer text shown when the notification is opened.
Button linkcta_urltext
The address the notification's button opens.
Button labelcta_texttext
The button's label. Needs a button link.
Tagstagslist
Free-form tags for filtering and grouping notifications.

Outputs

notificationobject
The notification
Example output
{
  "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

Notificationnotification_idtextRequired
The notification. Pick one, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once RescueTime accepts the delete
notificationobject
The notification
notification_idnumber
The id of the deleted notification
Example output
{
  "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

accountobject
The account's settings
Example output
{
  "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

Perspectiveperspectivetext
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).
Resolutionresolution_timetext
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 daterestrict_begindate
The first day to include. On the free Lite plan, reports cover the last 2 weeks only.
To daterestrict_enddate
The last day to include.
Group byrestrict_kindtext
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 itemrestrict_thingtext
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 documentrestrict_thingytext
Limit the report to one document or page within the item, such as a file name. Needs a paid plan's detailed tracking.
Devicesrestrict_source_typetext
Only time from computers, mobile devices or offline entries.One of: computers, mobile, offline (Offline time).
Rowslimitnumber
How many rows to return, 1 to 5000. Leave empty for all.From 1 to 5000.
Skip rowsoffsetnumber
How many rows to skip first, to read a report in pages.At least 0.

Outputs

countnumber
How many records this step returned
notestext
RescueTime's note on what the report holds
recordslist
The report's rows as records
row_headerslist
The report's column names, in row order
rowslist
The report's rows as RescueTime sends them
total_rowsnumber
How many rows the whole report has
Example output
{
  "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

userobject
The RescueTime user the API key belongs to
Example output
{
  "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

treeobject
Overviews, their categories and activities, as RescueTime nests them
Example output
{
  "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

Daydatedate
A whole day in your RescueTime time zone. Leave this and the window empty for today.
Window startdt_startdate and time
The start of a time window, instead of a day.
Window enddt_enddate and time
The end of the window. Defaults to the end of the start's day.
Meetings onlymeetings_onlytrue/false
On returns only events RescueTime counts as meetings, such as those with several attendees.Default: false.

Outputs

countnumber
How many records this step returned
eventslist
The events
Example output
{
  "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 containssearchtext
Only categories whose name contains this text. Leave empty for all.

Outputs

categorieslist
The categories
countnumber
How many records this step returned
Example output
{
  "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 IDsprofile_entity_idslist
Only these overrides, by id. Leave empty for all of them.

Outputs

countnumber
How many records this step returned
overrideslist
The overrides
Example output
{
  "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

countnumber
How many records this step returned
summarieslist
One per day
Example output
{
  "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 datestart_datedateRequired
The first day to include.
To dateend_datedateRequired
The last day to include. Today works too.
Full detailverbosetrue/false
On returns every figure for each day instead of the short form.Default: false.

Outputs

countnumber
How many records this step returned
summarieslist
One per day in the range
Example output
{
  "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 deviceall_devicestrue/false
On lists every device ever connected. Off lists those used in the last 90 days.Default: false.
Used sinceactive_sincedate and time
Only devices used at or after this time.

Outputs

countnumber
How many records this step returned
deviceslist
The devices
Example output
{
  "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

Showread_statustext
All current notifications, or only read or unread.One of: all (All current), read, unread. Default: all.

Outputs

countnumber
How many records this step returned
notificationslist
The notifications
Example output
{
  "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

countnumber
How many records this step returned
overviewslist
The overviews
Example output
{
  "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

countnumber
How many records this step returned
productivity_levelslist
The levels
Example output
{
  "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 IDentity_idtextRequired
The id of the app or website, from 'List category overrides' or 'Get overview tree'.
Document IDsub_entity_idtext
A document or page within the app, such as one site in a browser. Leave empty to change the whole app or website.
Categorycategory_idtext
The category to put it in. Leave empty to keep it.
Productivityscoretext
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

overrideobject
The saved override
Example output
{
  "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 trackingwindow_titlestext
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 filteradult_content_filtertext
On leaves adult websites out of tracking. Leave empty to keep the current setting.One of: on, off.

Outputs

accountobject
The account's settings
Example output
{
  "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

Notificationnotification_idtextRequired
The notification. Pick one, or give its id from an earlier step.
Mark asmark_astext
Mark the notification read or unread. Leave empty to keep it.One of: read, unread.
Dismissdismisstrue/false
On dismisses the notification, which hides it from the list.Default: false.

Outputs

notificationobject
The notification
Example output
{
  "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 namedisplay_nametext
The name shown in RescueTime. Leave empty to keep it.
Time zonetime_zonetext
A time zone name such as America/New_York or Europe/London. Leave empty to keep it.
Week starts onweek_start_daytext
The first day of the week in reports. Leave empty to keep it.One of: 0 (Sunday), 1 (Monday).
Weekly stats emailsend_stats_emailtext
Turn the weekly stats email on or off. Leave empty to keep it.One of: on, off.
Alert emailsalert_emailstext
Turn alert emails on or off. Leave empty to keep it.One of: on, off.

Outputs

userobject
The RescueTime user the API key belongs to
Example output
{
  "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
  }
}

On this page