# Everhour

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

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/everhour

## Actions

### Create client

Create a client to attach projects to.

**Inputs**

- Name (`name`, text, required): The name.
- Business details (`business_details`, text): Address or invoice details shown for the client.

**Outputs**

- `client` (object): The client

**Example output**

```json
{
  "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**

- Name (`name`, text, required): The name.
- Client (`client_id`, text): The client this project is for. Leave empty to keep it as is.
- Billing (`billing_type`, text): 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 fee (`amount`, number): 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**

- `project` (object): The project

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, or give its id (such as ev:123) from an earlier step.
- Name (`name`, text, required): The name.
- Description (`description`, text): What the task is about.
- Due date (`due_date`, date): When the task is due.
- Labels (`labels`, list): Labels to put on the task, one per row.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "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**

- Client (`client_id`, text, required): The client. Pick one, or give its id from an earlier step.

**Outputs**

- `client_id` (text): The client deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "client_id": "7654321",
  "deleted": true
}
```

### Delete project

Delete a project with all its tasks and tracked time.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id (such as ev:123) from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `project_id` (text): The project deleted

**Example output**

```json
{
  "deleted": true,
  "project_id": "ev:1111111111"
}
```

### Delete task

Delete a task with the time tracked on it.

**Inputs**

- Task ID (`task_id`, text, required): The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `task_id` (text): The task deleted

**Example output**

```json
{
  "deleted": true,
  "task_id": "ev:2222222222"
}
```

### Get client

Get one client with its business details and projects.

**Inputs**

- Client (`client_id`, text, required): The client. Pick one, or give its id from an earlier step.

**Outputs**

- `client` (object): The client

**Example output**

```json
{
  "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**

- `user` (object): The connected user

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, or give its id (such as ev:123) from an earlier step.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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_running` (true/false): True while the timer is running
- `timer` (object): The timer

**Example output**

```json
{
  "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 ID (`task_id`, text, required): The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "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**

- `clients` (list): The clients
- `count` (number): How many were returned

**Example output**

```json
{
  "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 contains (`query`, text): Only projects whose name contains this text.
- Page size (`limit`, number): How many to return, 1 to 250. From 1 to 250.

**Outputs**

- `count` (number): How many were returned
- `projects` (list): The projects

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, or give its id (such as ev:123) from an earlier step.
- Name contains (`query`, text): Only tasks whose name contains this text.
- Include closed tasks (`include_closed`, true/false): Also return tasks that are closed. Off by default. Default: `false`.
- Page size (`limit`, number): How many to return, 1 to 250. From 1 to 250.
- Page (`page`, number): Which page to get, starting at 1. Use the next page an earlier run gave. At least 1.

**Outputs**

- `count` (number): How many were returned
- `next_page` (number): The page to ask for next, or 0 when there are no more
- `tasks` (list): The tasks

**Example output**

```json
{
  "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**

- `count` (number): How many were returned
- `users` (list): The team's users

**Example output**

```json
{
  "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 ID (`task_id`, text, required): The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.

**Outputs**

- `count` (number): How many were returned
- `time_records` (list): The time records

**Example output**

```json
{
  "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**

- Person (`person_id`, text): Whose time. Leave empty for yourself; other people need an admin or supervisor role in Everhour.
- From (`from_date`, date): First day to include.
- To (`to_date`, date): Last day to include.
- Page size (`limit`, number): How many to return, 1 to 250. From 1 to 250.

**Outputs**

- `count` (number): How many were returned
- `time_records` (list): The time records
- `total_seconds` (number): Seconds across the records returned

**Example output**

```json
{
  "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 ID (`task_id`, text, required): The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.
- Day (`date`, date, required): The day the work was done.
- Hours (`hours`, number, required): Time worked in hours; 1.5 is an hour and a half. From 0.01 to 24.
- Comment (`comment`, text): A note to keep with the time.
- Person (`person_id`, text): Whose time. Leave empty for yourself; other people need an admin or supervisor role in Everhour.

**Outputs**

- `date` (text): The day, YYYY-MM-DD
- `seconds` (number): The time sent, in seconds
- `task_id` (text): The task
- `time_record` (object): The time record

**Example output**

```json
{
  "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 for (`query`, text, required): Text to look for in task names.
- Include closed tasks (`include_closed`, true/false): Also return tasks that are closed. Off by default. Default: `false`.
- Page size (`limit`, number): How many to return, 1 to 250. From 1 to 250.

**Outputs**

- `count` (number): How many were returned
- `tasks` (list): The matching tasks

**Example output**

```json
{
  "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 ID (`task_id`, text, required): The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.
- Hours (`hours`, number, required): Estimated hours; 1.5 is an hour and a half. From 0.01 to 1000.

**Outputs**

- `estimate` (object): The estimate Everhour kept
- `estimate_seconds` (number): The estimate sent, in seconds
- `task_id` (text): The task

**Example output**

```json
{
  "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 ID (`task_id`, text, required): The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.
- Day (`date`, date): Record the time against this day. Defaults to today.
- Comment (`comment`, text): A note to keep with the time.

**Outputs**

- `is_running` (true/false): True while the timer is running
- `timer` (object): The timer

**Example output**

```json
{
  "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_running` (true/false): True while the timer is running
- `timer` (object): The timer

**Example output**

```json
{
  "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**

- Client (`client_id`, text, required): The client. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Business details (`business_details`, text): New business details. Leave empty to keep them.

**Outputs**

- `client` (object): The client

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, or give its id (such as ev:123) from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Client (`client_id`, text): The client this project is for. Leave empty to keep it as is.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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 ID (`task_id`, text, required): The task's id (such as ev:123), from 'List tasks', 'Search tasks' or 'Create task'.
- Name (`name`, text): A new name. Leave empty to keep it.
- Description (`description`, text): What the task is about.
- Due date (`due_date`, date): When the task is due.
- Labels (`labels`, list): Labels to put on the task, one per row.
- Status (`status`, text): Close or reopen the task. Leave empty to keep it. One of: `open`, `closed`.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "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
    }
  }
}
```
