Everhour

App · 25 actions

Track time with Everhour: create and update clients, projects and tasks, log hours, read time records, and start or stop your timer.

Actions

ActionWhat it does
Create clientCreate a client to attach projects to.
Create projectCreate a project, optionally for a client and billable.
Create taskCreate a task in a project.
Delete clientDelete a client.
Delete projectDelete a project with all its tasks and tracked time.
Delete taskDelete a task with the time tracked on it.
Get clientGet one client with its business details and projects.
Get current userGet the Everhour user the connection acts as: name, email, role and team.
Get projectGet one project with its client, billing and members.
Get running timerCheck whether your timer is running and on which task.
Get taskGet one task with its status, estimate and tracked time.
List clientsList the team's clients.
List projectsList projects, optionally only those whose name contains some text.
List tasksList the tasks in a project, open ones unless closed are asked for.
List team usersList everyone on the team with their roles and statuses.
List time on a taskList the time records logged on a task, by everyone.
List time recordsList a person's time records between two days, with the total seconds.
Log time on a taskRecord hours worked on a task on a given day, for yourself or (with an admin or supervisor role) a teammate.
Search tasksFind tasks in any project whose name contains some text.
Set task estimateSet how many hours the whole task is expected to take.
Start timerStart your timer on a task.
Stop timerStop your running timer and record its time on the task.
Update clientRename a client or change its business details.
Update projectRename a project or move it to another client.
Update taskChange a task's name, description, due date, labels or status.

Create client

Create a client to attach projects to.

Inputs

NamenametextRequired
The name.
Business detailsbusiness_detailstext
Address or invoice details shown for the client.

Outputs

clientobject
The client
Example output
{
  "client": {
    "businessDetails": "1 Main Street",
    "createdAt": "2026-01-06 09:00:00",
    "id": 7654321,
    "name": "Acme Inc",
    "projects": [
      "ev:1111111111"
    ]
  }
}

Create project

Create a project, optionally for a client and billable.

Inputs

NamenametextRequired
The name.
Clientclient_idtext
The client this project is for. Leave empty to keep it as is.
Billingbilling_typetext
Whether time on the project is billable. Defaults to non-billable.One of: non_billable (Non-billable (default)), hourly (Billable, hourly rate), fixed_fee (Billable, fixed fee).
Hourly rate or feeamountnumber
The hourly rate, or the fixed fee, in your Everhour currency (such as 50 or 62.5). Needed when billing is hourly or fixed fee.At least 0.01.

Outputs

projectobject
The project
Example output
{
  "project": {
    "billing": {
      "type": "hourly"
    },
    "client": 7654321,
    "createdAt": "2026-01-07 09:00:00",
    "favorite": false,
    "id": "ev:1111111111",
    "name": "Website redesign",
    "platform": "ev",
    "rate": {
      "rate": 5000,
      "type": "project_rate"
    },
    "status": "open",
    "type": "list",
    "users": [
      1234567
    ]
  }
}

Create task

Create a task in a project.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id (such as ev:123) from an earlier step.
NamenametextRequired
The name.
Descriptiondescriptiontext
What the task is about.
Due datedue_datedate
When the task is due.
Labelslabelslist
Labels to put on the task, one per row.

Outputs

taskobject
The task
Example output
{
  "task": {
    "createdAt": "2026-01-08 09:00:00",
    "description": "First round of mockups.",
    "dueOn": "2026-11-20",
    "estimate": {
      "total": 7200,
      "type": "overall"
    },
    "id": "ev:2222222222",
    "labels": [
      "design"
    ],
    "name": "Design the home page",
    "projects": [
      "ev:1111111111"
    ],
    "status": "open",
    "time": {
      "total": 3600
    }
  }
}

Delete client

Delete a client. Its projects stay, without a client.

Inputs

Clientclient_idtextRequired
The client. Pick one, or give its id from an earlier step.

Outputs

client_idtext
The client deleted
deletedtrue/false
Always true once deleted
Example output
{
  "client_id": "7654321",
  "deleted": true
}

Delete project

Delete a project with all its tasks and tracked time.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id (such as ev:123) from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
project_idtext
The project deleted
Example output
{
  "deleted": true,
  "project_id": "ev:1111111111"
}

Delete task

Delete a task with the time tracked on it.

Inputs

Task IDtask_idtextRequired
The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.

Outputs

deletedtrue/false
Always true once deleted
task_idtext
The task deleted
Example output
{
  "deleted": true,
  "task_id": "ev:2222222222"
}

Get client

Get one client with its business details and projects.

Inputs

Clientclient_idtextRequired
The client. Pick one, or give its id from an earlier step.

Outputs

clientobject
The client
Example output
{
  "client": {
    "businessDetails": "1 Main Street",
    "createdAt": "2026-01-06 09:00:00",
    "id": 7654321,
    "name": "Acme Inc",
    "projects": [
      "ev:1111111111"
    ]
  }
}

Get current user

Get the Everhour user the connection acts as: name, email, role and team.

Inputs

None.

Outputs

userobject
The connected user
Example output
{
  "user": {
    "createdAt": "2026-01-05 09:00:00",
    "email": "jo@example.com",
    "headline": "Designer",
    "id": 1234567,
    "name": "Jo Bloggs",
    "role": "admin",
    "status": "active"
  }
}

Get project

Get one project with its client, billing and members.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id (such as ev:123) from an earlier step.

Outputs

projectobject
The project
Example output
{
  "project": {
    "billing": {
      "type": "hourly"
    },
    "client": 7654321,
    "createdAt": "2026-01-07 09:00:00",
    "favorite": false,
    "id": "ev:1111111111",
    "name": "Website redesign",
    "platform": "ev",
    "rate": {
      "rate": 5000,
      "type": "project_rate"
    },
    "status": "open",
    "type": "list",
    "users": [
      1234567
    ]
  }
}

Get running timer

Check whether your timer is running and on which task. 'is_running' is false when it is stopped.

Inputs

None.

Outputs

is_runningtrue/false
True while the timer is running
timerobject
The timer
Example output
{
  "is_running": true,
  "timer": {
    "comment": "",
    "duration": 120,
    "startedAt": "2026-11-03 09:00:00",
    "status": "active",
    "task": {
      "id": "ev:2222222222",
      "name": "Design the home page"
    },
    "today": 3720,
    "user": {
      "id": 1234567,
      "name": "Jo Bloggs"
    },
    "userDate": "2026-11-03"
  }
}

Get task

Get one task with its status, estimate and tracked time.

Inputs

Task IDtask_idtextRequired
The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.

Outputs

taskobject
The task
Example output
{
  "task": {
    "createdAt": "2026-01-08 09:00:00",
    "description": "First round of mockups.",
    "dueOn": "2026-11-20",
    "estimate": {
      "total": 7200,
      "type": "overall"
    },
    "id": "ev:2222222222",
    "labels": [
      "design"
    ],
    "name": "Design the home page",
    "projects": [
      "ev:1111111111"
    ],
    "status": "open",
    "time": {
      "total": 3600
    }
  }
}

List clients

List the team's clients.

Inputs

None.

Outputs

clientslist
The clients
countnumber
How many were returned
Example output
{
  "clients": [
    {
      "businessDetails": "1 Main Street",
      "createdAt": "2026-01-06 09:00:00",
      "id": 7654321,
      "name": "Acme Inc",
      "projects": [
        "ev:1111111111"
      ]
    }
  ],
  "count": 1
}

List projects

List projects, optionally only those whose name contains some text.

Inputs

Name containsquerytext
Only projects whose name contains this text.
Page sizelimitnumber
How many to return, 1 to 250.From 1 to 250.

Outputs

countnumber
How many were returned
projectslist
The projects
Example output
{
  "count": 1,
  "projects": [
    {
      "billing": {
        "type": "hourly"
      },
      "client": 7654321,
      "createdAt": "2026-01-07 09:00:00",
      "favorite": false,
      "id": "ev:1111111111",
      "name": "Website redesign",
      "platform": "ev",
      "rate": {
        "rate": 5000,
        "type": "project_rate"
      },
      "status": "open",
      "type": "list",
      "users": [
        1234567
      ]
    }
  ]
}

List tasks

List the tasks in a project, open ones unless closed are asked for. Gets one page; to see more, run it again with the next page it gives.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id (such as ev:123) from an earlier step.
Name containsquerytext
Only tasks whose name contains this text.
Include closed tasksinclude_closedtrue/false
Also return tasks that are closed. Off by default.Default: false.
Page sizelimitnumber
How many to return, 1 to 250.From 1 to 250.
Pagepagenumber
Which page to get, starting at 1. Use the next page an earlier run gave.At least 1.

Outputs

countnumber
How many were returned
next_pagenumber
The page to ask for next, or 0 when there are no more
taskslist
The tasks
Example output
{
  "count": 1,
  "next_page": 0,
  "tasks": [
    {
      "createdAt": "2026-01-08 09:00:00",
      "description": "First round of mockups.",
      "dueOn": "2026-11-20",
      "estimate": {
        "total": 7200,
        "type": "overall"
      },
      "id": "ev:2222222222",
      "labels": [
        "design"
      ],
      "name": "Design the home page",
      "projects": [
        "ev:1111111111"
      ],
      "status": "open",
      "time": {
        "total": 3600
      }
    }
  ]
}

List team users

List everyone on the team with their roles and statuses.

Inputs

None.

Outputs

countnumber
How many were returned
userslist
The team's users
Example output
{
  "count": 1,
  "users": [
    {
      "createdAt": "2026-01-05 09:00:00",
      "email": "jo@example.com",
      "headline": "Designer",
      "id": 1234567,
      "name": "Jo Bloggs",
      "role": "admin",
      "status": "active"
    }
  ]
}

List time on a task

List the time records logged on a task, by everyone.

Inputs

Task IDtask_idtextRequired
The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.

Outputs

countnumber
How many were returned
time_recordslist
The time records
Example output
{
  "count": 1,
  "time_records": [
    {
      "comment": "Mockups",
      "createdAt": "2026-11-02 17:00:00",
      "date": "2026-11-02",
      "id": "rec_9876543",
      "task": {
        "id": "ev:2222222222",
        "name": "Design the home page"
      },
      "time": 5400,
      "user": 1234567
    }
  ]
}

List time records

List a person's time records between two days, with the total seconds. Yourself unless you pick someone else.

Inputs

Personperson_idtext
Whose time. Leave empty for yourself; other people need an admin or supervisor role in Everhour.
Fromfrom_datedate
First day to include.
Toto_datedate
Last day to include.
Page sizelimitnumber
How many to return, 1 to 250.From 1 to 250.

Outputs

countnumber
How many were returned
time_recordslist
The time records
total_secondsnumber
Seconds across the records returned
Example output
{
  "count": 1,
  "time_records": [
    {
      "comment": "Mockups",
      "createdAt": "2026-11-02 17:00:00",
      "date": "2026-11-02",
      "id": "rec_9876543",
      "task": {
        "id": "ev:2222222222",
        "name": "Design the home page"
      },
      "time": 5400,
      "user": 1234567
    }
  ],
  "total_seconds": 5400
}

Log time on a task

Record hours worked on a task on a given day, for yourself or (with an admin or supervisor role) a teammate.

Inputs

Task IDtask_idtextRequired
The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.
DaydatedateRequired
The day the work was done.
HourshoursnumberRequired
Time worked in hours; 1.5 is an hour and a half.From 0.01 to 24.
Commentcommenttext
A note to keep with the time.
Personperson_idtext
Whose time. Leave empty for yourself; other people need an admin or supervisor role in Everhour.

Outputs

datetext
The day, YYYY-MM-DD
secondsnumber
The time sent, in seconds
task_idtext
The task
time_recordobject
The time record
Example output
{
  "date": "2026-11-02",
  "seconds": 5400,
  "task_id": "ev:2222222222",
  "time_record": {
    "comment": "Mockups",
    "createdAt": "2026-11-02 17:00:00",
    "date": "2026-11-02",
    "id": "rec_9876543",
    "task": {
      "id": "ev:2222222222",
      "name": "Design the home page"
    },
    "time": 5400,
    "user": 1234567
  }
}

Search tasks

Find tasks in any project whose name contains some text.

Inputs

Search forquerytextRequired
Text to look for in task names.
Include closed tasksinclude_closedtrue/false
Also return tasks that are closed. Off by default.Default: false.
Page sizelimitnumber
How many to return, 1 to 250.From 1 to 250.

Outputs

countnumber
How many were returned
taskslist
The matching tasks
Example output
{
  "count": 1,
  "tasks": [
    {
      "createdAt": "2026-01-08 09:00:00",
      "description": "First round of mockups.",
      "dueOn": "2026-11-20",
      "estimate": {
        "total": 7200,
        "type": "overall"
      },
      "id": "ev:2222222222",
      "labels": [
        "design"
      ],
      "name": "Design the home page",
      "projects": [
        "ev:1111111111"
      ],
      "status": "open",
      "time": {
        "total": 3600
      }
    }
  ]
}

Set task estimate

Set how many hours the whole task is expected to take.

Inputs

Task IDtask_idtextRequired
The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.
HourshoursnumberRequired
Estimated hours; 1.5 is an hour and a half.From 0.01 to 1000.

Outputs

estimateobject
The estimate Everhour kept
estimate_secondsnumber
The estimate sent, in seconds
task_idtext
The task
Example output
{
  "estimate": {
    "total": 7200,
    "type": "overall"
  },
  "estimate_seconds": 7200,
  "task_id": "ev:2222222222"
}

Start timer

Start your timer on a task. A timer that is already running is stopped and its time recorded first.

Inputs

Task IDtask_idtextRequired
The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.
Daydatedate
Record the time against this day. Defaults to today.
Commentcommenttext
A note to keep with the time.

Outputs

is_runningtrue/false
True while the timer is running
timerobject
The timer
Example output
{
  "is_running": true,
  "timer": {
    "comment": "",
    "duration": 120,
    "startedAt": "2026-11-03 09:00:00",
    "status": "active",
    "task": {
      "id": "ev:2222222222",
      "name": "Design the home page"
    },
    "today": 3720,
    "user": {
      "id": 1234567,
      "name": "Jo Bloggs"
    },
    "userDate": "2026-11-03"
  }
}

Stop timer

Stop your running timer and record its time on the task.

Inputs

None.

Outputs

is_runningtrue/false
True while the timer is running
timerobject
The timer
Example output
{
  "is_running": false,
  "timer": {
    "comment": "",
    "duration": 120,
    "startedAt": "2026-11-03 09:00:00",
    "status": "stopped",
    "task": {
      "id": "ev:2222222222",
      "name": "Design the home page"
    },
    "today": 3720,
    "user": {
      "id": 1234567,
      "name": "Jo Bloggs"
    },
    "userDate": "2026-11-03"
  }
}

Update client

Rename a client or change its business details.

Inputs

Clientclient_idtextRequired
The client. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Business detailsbusiness_detailstext
New business details. Leave empty to keep them.

Outputs

clientobject
The client
Example output
{
  "client": {
    "businessDetails": "1 Main Street",
    "createdAt": "2026-01-06 09:00:00",
    "id": 7654321,
    "name": "Acme Corporation",
    "projects": [
      "ev:1111111111"
    ]
  }
}

Update project

Rename a project or move it to another client.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id (such as ev:123) from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Clientclient_idtext
The client this project is for. Leave empty to keep it as is.

Outputs

projectobject
The project
Example output
{
  "project": {
    "billing": {
      "type": "hourly"
    },
    "client": 7654321,
    "createdAt": "2026-01-07 09:00:00",
    "favorite": false,
    "id": "ev:1111111111",
    "name": "Website relaunch",
    "platform": "ev",
    "rate": {
      "rate": 5000,
      "type": "project_rate"
    },
    "status": "open",
    "type": "list",
    "users": [
      1234567
    ]
  }
}

Update task

Change a task's name, description, due date, labels or status. Only the fields given change.

Inputs

Task IDtask_idtextRequired
The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.
Namenametext
A new name. Leave empty to keep it.
Descriptiondescriptiontext
What the task is about.
Due datedue_datedate
When the task is due.
Labelslabelslist
Labels to put on the task, one per row.
Statusstatustext
Close or reopen the task. Leave empty to keep it.One of: open, closed.

Outputs

taskobject
The task
Example output
{
  "task": {
    "createdAt": "2026-01-08 09:00:00",
    "description": "First round of mockups.",
    "dueOn": "2026-11-20",
    "estimate": {
      "total": 7200,
      "type": "overall"
    },
    "id": "ev:2222222222",
    "labels": [
      "design"
    ],
    "name": "Design the home page",
    "projects": [
      "ev:1111111111"
    ],
    "status": "closed",
    "time": {
      "total": 3600
    }
  }
}

On this page