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
| Action | What it does |
|---|---|
| Count notifications | Count the current notifications in your RescueTime app that are read and unread. |
| Create notification | Post a notification into your RescueTime app, with an optional body, button and tags. |
| Delete notification | Delete a notification from your RescueTime app for good. |
| Get account settings | Get the account's tracking settings: whether window titles are tracked and whether adult websites are filtered out. |
| Get activity report | Get time spent per app, website, category or productivity level for a date range, ranked or over time. |
| Get current user | Get the RescueTime user the API key belongs to: name, email, time zone and first day of the week. |
| Get overview tree | Get every overview with its categories and activities, with your own productivity scores applied. |
| List calendar events | List events from the calendar connected to RescueTime for a day or a time window, optionally only meetings. |
| List categories | List the categories RescueTime sorts apps and websites into, such as Accounting under Business, with their ids. |
| List category overrides | List the apps and websites whose category or productivity you have changed, with the app or website and category included. |
| 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. |
| List daily summaries for dates | List daily time summaries for any date range, today included. |
| List devices | List the computers and phones that report to RescueTime. |
| List notifications | List the notifications in your RescueTime app that are not dismissed or expired, optionally only read or unread ones. |
| List overviews | List the top-level categories, such as Business, Entertainment and Software Development. |
| List productivity levels | List the five productivity levels with their scores, from very distracting (-2) to very productive (2). |
| Set activity category | Give an app or website your own category, productivity score, or both. |
| Update account settings | Turn window title tracking or the adult content filter on or off. |
| Update notification | Mark a notification read or unread, dismiss it, or both in one step. |
| Update user profile | Change 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
- Subject
subjecttextRequired - The headline shown in the notification list.
- Body
bodytext - The longer text shown when the notification is opened.
- Button link
cta_urltext - The address the notification's button opens.
- Button label
cta_texttext - The button's label. Needs a button link.
- Tags
tagslist - 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
- Notification
notification_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
- Perspective
perspectivetext - 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_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 date
restrict_begindate - The first day to include. On the free Lite plan, reports cover the last 2 weeks only.
- To date
restrict_enddate - The last day to include.
- Group by
restrict_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 item
restrict_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 document
restrict_thingytext - 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_typetext - Only time from computers, mobile devices or offline entries.One of:
computers,mobile,offline(Offline time). - Rows
limitnumber - How many rows to return, 1 to 5000. Leave empty for all.From 1 to 5000.
- Skip rows
offsetnumber - 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
- Day
datedate - A whole day in your RescueTime time zone. Leave this and the window empty for today.
- Window start
dt_startdate and time - The start of a time window, instead of a day.
- Window end
dt_enddate and time - The end of the window. Defaults to the end of the start's day.
- Meetings only
meetings_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 contains
searchtext - 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 IDs
profile_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 date
start_datedateRequired - The first day to include.
- To date
end_datedateRequired - The last day to include. Today works too.
- Full detail
verbosetrue/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 device
all_devicestrue/false - On lists every device ever connected. Off lists those used in the last 90 days.Default:
false. - Used since
active_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
- Show
read_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 ID
entity_idtextRequired - The id of the app or website, from 'List category overrides' or 'Get overview tree'.
- Document ID
sub_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.
- Category
category_idtext - The category to put it in. Leave empty to keep it.
- Productivity
scoretext - 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 tracking
window_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 filter
adult_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
- Notification
notification_idtextRequired - The notification. Pick one, or give its id from an earlier step.
- Mark as
mark_astext - Mark the notification read or unread. Leave empty to keep it.One of:
read,unread. - Dismiss
dismisstrue/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 name
display_nametext - The name shown in RescueTime. Leave empty to keep it.
- Time zone
time_zonetext - A time zone name such as America/New_York or Europe/London. Leave empty to keep it.
- Week starts on
week_start_daytext - The first day of the week in reports. Leave empty to keep it.One of:
0(Sunday),1(Monday). - Weekly stats email
send_stats_emailtext - Turn the weekly stats email on or off. Leave empty to keep it.One of:
on,off. - Alert emails
alert_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
}
}