Everhour

Attach a previously uploaded file (by its token from `POST /attachments`) to an existing expense.

Add a time record (in seconds) for a user on a given task and date. **Upsert:** at most one time record exists per `(user, date, task)`. Posting again with the same combination updates the existing record's duration instead of creating a duplicate. To update a specific record by ID, use `PUT /time/{time_id}`. See [Dates](/dates-and-timezones) for accepted date and duration formats.

Approve or reject an existing timesheet approval request. Use this endpoint to act on a request previously created with `POST /timesheets/{timesheet_id}/approval`. The response reflects the resulting approval state.

Submit a timesheet week for approval. The week's owner uses this endpoint to request review; an approver acts on the request via `PUT /timesheets/{timesheet_id}/approval`. The `timesheet_id` is the concatenation of `user_id` and a 4-digit `week_id` in `YYWW` format (no separator). Example: user `14856` for week `2535` (week 35 of 2025) → `timesheet_id = 148562535`. See the Timesheets overview for the full Week ID definition.

Archive or unarchive a project. Archived projects are hidden from default listings but their data is preserved.

Aggregated client report. Same filters and units as `GET /dashboards/projects` — see [Concepts](/concepts).

Clock a user in. Starts a new timecard segment at the current time.

Clock a user out. Closes the current timecard segment.

Create a time-off allocation for a user and time-off type.

Create a schedule assignment. To create time-off use `POST /resource-planner/assignments/time-off` instead.

Upload a file and receive a one-time attachment token. The token can then be attached to an expense via `POST /expenses/{expense_id}/attachments` or included in `POST /expenses`.

Create a new expense category.

Create a new client. Names are not deduplicated — posting the same name creates another client.

Log a new expense. Amounts are in cents (see [Concepts](/concepts)); attach files first via `POST /attachments` and reference their IDs in the request body.

Create a new custom field on a project.

Create an invoice for a client. The invoice is generated from the client's tracked time over the requested date range — see [Dates](/dates-and-timezones).

Create a new project. To copy from an existing template use the `template` or `publicTemplate` body field. To sync a project from a connected integration use `POST /projects/{project_id}/sync` instead.

Create a new section in a project.

Create a task in a project. For tasks coming from connected integrations, sync them via `POST /projects/{project_id}/sync` instead.

Create a new time-off type.

Register a new webhook subscription. **Handshake:** on create, Everhour sends a POST to the supplied `targetUrl` with an `X-Hook-Secret` header (HMAC-SHA512) and an empty body. The receiver must respond with a 2xx status to complete verification. Send `X-Skip-Handshake: 1` to skip verification when the receiver cannot participate. **Scope:** a webhook can listen across the whole team or be scoped to a single project. See [Webhooks](/webhooks) for event types, payload structure, and delivery semantics.

Delete a time-off allocation.

Delete a schedule assignment. You can include an optional `reason` (max 1000 characters) in the request body.

Delete an attachment and its underlying file.

Delete an expense category. Expenses already assigned to it are kept but become uncategorized.

Delete a client.

Remove the budget attached to a client. The client itself is kept.

Delete an expense entry. Attached files are also removed.

Delete a custom field. Existing task values for that field are discarded.

Delete an invoice. Time records attached to the invoice are released and become billable again.

Delete a project, its tasks, and all associated time records. This is irreversible.

Delete a section. Tasks in the section are kept but become section-less.

Delete a task and all of its time records.

Remove a task's estimate.

Delete a time-off type. Existing time-off entries that reference it are kept.

Remove a time record by setting its duration to zero. The history trail is preserved; the row no longer appears in time listings, which filter for `time > 0`.

Delete a user's timecard entry for a specific date.

Delete a webhook subscription. Stops further deliveries; no event is sent for the deletion itself.

Retract the caller's previously submitted approval request for a week. The week returns to draft state.

Download the binary contents of an attachment by its token. The response is the raw file, not JSON.

Legacy export of team estimates, returned as JSON. Requires admin access. Kept for backward compatibility; new integrations should use the dashboard reports.

Export an invoice to a connected external accounting system. Supports Xero, QuickBooks, and FreshBooks integrations — the destination must be linked to the team beforehand. An invoice can only be exported once; subsequent calls return an error.

List per-user time-off allocations (e.g. annual vacation balances).

List schedule assignments across the team. Supports filtering by date range, project, and member.

List expense categories available in the team.

Search Clients by Name using the query parameter.

List expenses logged by the authenticated user.

List invoices in the team. Supports filtering by date and client.

List projects the caller has access to. Use the `query` parameter to search by name and `limit`/`page` for pagination — see [Pagination](/pagination).

List the timers currently running across the team — one entry per active user.

List time records across the entire team for a date range. When `from`/`to` are omitted, only the current day is returned. See [Dates](/dates-and-timezones).

List timecards across the team. Defaults to the last two weeks when no date range is provided — see [Dates](/dates-and-timezones).

List all members of the team. Supports `query` for name search and `limit` for pagination — see [Pagination](/pagination).

List all webhook subscriptions created with your API key.

Retrieve a single client by ID.

Retrieve the user that owns the API key, including personal settings (timezone, formats, API key).

Retrieve a single invoice with its full line-item breakdown.

Retrieve a single project. See [Concepts](/concepts) for the project model.

List the custom fields configured on a project, in display order.

List sections (groupings of tasks) within a project.

List tasks in a project. By default all tasks are returned; set `exclude-closed=true` to hide closed/completed tasks. See [Pagination](/pagination) for `limit`/`page` rules.

List time records logged against a single project, across all users and tasks.

Retrieve the authenticated user's currently running timer, or an empty timer payload if none is running.

Retrieve a single section by ID.

Retrieve a single task with its time totals, estimate, and custom fields.

List time records logged against a single task, across all users.

List timesheet weeks across the team, grouped by user.

List the time-off types defined for the team (e.g. Vacation, Sick Leave).

Retrieve a user's timecard for a specific date.

List time records for a single user. Supports the same filters as `GET /team/time`.

List timecards for a single user. Defaults to the last two weeks when no date range is provided.

List timesheet weeks for a single user. The week id is the Monday date of the week (see [Dates](/dates-and-timezones)).

Retrieve a single webhook subscription.

Aggregated project report. Returns time, billing, and budget figures grouped by project. Filter the result with `date.gte`, `date.lte`, `projectId`, `clientId`, and `memberId` query parameters — see [Dates](/dates-and-timezones) for parameter formats. Time columns are in seconds, amounts in cents (see [Concepts](/concepts)).

Refresh an invoice's line items from current time records. The invoice's billable items are rebuilt from the underlying time tracked against the invoice's client over its date range. Useful when time records have been added, edited, or deleted after the invoice was first generated.

Reorder a project's custom fields. Send the full list of field IDs in the desired order.

Search tasks within a single project. Same query semantics as `GET /tasks/search`; `limit` must be between 1 and 100.

Search tasks across all projects by name. The `limit` parameter must be between 1 and 100.

Start a timer for the authenticated user on a given task. Only one timer can run per user at a time. If the user already has a timer running on another task, that timer is stopped automatically before the new one starts; the stopped run is committed to a time record on its own date (the date the timer was started, which may not be today for cross-midnight runs). See [Concepts](/concepts) for timer semantics.

Stop the authenticated user's currently running timer. The accumulated duration is committed to a time record on the timer's task for the current date and returned in the response.

Sync new integration projects to Everhour. Traditionally, project sync relied on background jobs which could delay access to Everhour functionality. This endpoint allows instant synchronization of a project from a connected integration (like Trello, Asana, ClickUp, etc.) into Everhour. Useful for automation flows where you want to start working with a project immediately after creating it in your external tool. Safe to call multiple times — if the project already exists in Everhour, it simply returns it without creating duplicates. **Workflow** - Create a project in your external tool (Asana, Trello, etc.) and retrieve its ID. - Sync it to Everhour using this endpoint in Everhour API. - Proceed with other Everhour API actions — assign a budget, link a client, or set task estimates. Supported platform codes: as, b2, b3, bb, cl, gh, gl, in, li, mo, no, td, tw, tr, wr.

Legacy export of team time records, returned as JSON. Kept for backward compatibility; new integrations should use `GET /team/time` or the dashboard reports.

Update a time-off allocation's amount or period.

Update an existing schedule assignment.

Update an expense category.

Update an existing client. Only the fields supplied in the body are modified.

Create or replace the budget attached to a client. Send a complete budget object; partial updates are not supported.

Update an existing expense entry.

Update a custom field's name, type-specific options, or visibility.

Update invoice metadata (notes, dates, custom totals). To change the lifecycle state, set `manualStatus` to `draft`, `sent`, or `paid`.

Update project settings. To change budget or billable rate, use `PUT /projects/{project_id}/billing` instead.

Set or update the project's budget, billable rate, and billing type in a single call. Amounts are in cents (see [Concepts](/concepts)).

Update a section's name or position.

Update task fields (name, status, due date, section, labels).

Set a task's billing rate or mark it non-billable. Requires admin access. The same values are returned on task responses when you pass `opts_include_billing=1`.

Set or replace a task's estimate (in seconds). Send a complete estimate object; partial updates are not supported.

Update a time-off type's name, color, or settings.

Update a specific time record by ID. To add or upsert time, use `POST /time` instead.

Update (or create, if missing) a user's timecard for a specific date. Suitable for manual edits — clock-in and clock-out have dedicated endpoints.

Update a webhook's events or scope. The `targetUrl` cannot be changed and is ignored if sent; the handshake is repeated against the existing URL to confirm it is still reachable. Send `X-Skip-Handshake: 1` to skip it.

Aggregated member report. Same filters and units as `GET /dashboards/projects` — see [Concepts](/concepts).