Everhour

Delete Allocation. DELETE /allocations/{allocation_id}. Delete a time-off allocation.

Delete Attachment. DELETE /attachments/{attachment_id}. Delete an attachment and its underlying file.

Delete Client. DELETE /clients/{client_id}. Delete a client.

Delete Client Budget. DELETE /clients/{client_id}/budget. Remove the budget attached to a client. The client itself is kept.

Delete Expense. DELETE /expenses/{expense_id}. Delete an expense entry. Attached files are also removed.

Delete Category. DELETE /expenses/categories/{category_id}. Delete an expense category. Expenses already assigned to it are kept but become uncategorized.

Delete Field. DELETE /fields/{field_id}. Delete a custom field. Existing task values for that field are discarded.

Delete Webhook. DELETE /hooks/{hook_id}. Delete a webhook subscription. Stops further deliveries; no event is sent for the deletion itself.

Delete Invoice. DELETE /invoices/{invoice_id}. Delete an invoice. Time records attached to the invoice are released and become billable again.

Delete Project. DELETE /projects/{project_id}. Delete a project, its tasks, and all associated time records. This is irreversible.

Delete Assignment. DELETE /resource-planner/assignments/{assignment_id}. Delete a schedule assignment. You can include an optional `reason` (max 1000 characters) in the request body.

Delete Time Off Type. DELETE /resource-planner/time-off-types/{type_id}. Delete a time-off type. Existing time-off entries that reference it are kept.

Delete Section. DELETE /sections/{section_id}. Delete a section. Tasks in the section are kept but become section-less.

Delete Task. DELETE /tasks/{task_id}. Delete a task and all of its time records.

Delete Task Estimate. DELETE /tasks/{task_id}/estimate. Remove a task's estimate.

Delete Time Record. DELETE /time/{time_id}. 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`.

Stop Timer. DELETE /timers/current. 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.

Delete Timecard. DELETE /users/{user_id}/timecards/{date}. Delete a user's timecard entry for a specific date.

Get All Allocations. GET /allocations. List per-user time-off allocations (e.g. annual vacation balances).

Download Attachment. GET /attachments/{attachment_token}/download. Download the binary contents of an attachment by its token. The response is the raw file, not JSON. Returned as JSON: content_type, content_length and the bytes as content_base64 when the file is at most 4 MB; a larger file is described in `detail` and not carried.

Get All Clients. GET /clients. Search Clients by Name using the query parameter.

Get Client. GET /clients/{client_id}. Retrieve a single client by ID.

Clients Report. GET /dashboards/clients. Aggregated client report. Same filters and units as `GET /dashboards/projects` — see Concepts.

Projects Report. GET /dashboards/projects. 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 for parameter formats. Time columns are in seconds, amounts in cents (see Concepts).

Users Report. GET /dashboards/users. Aggregated member report. Same filters and units as `GET /dashboards/projects` — see Concepts.

Get All Expenses. GET /expenses. List expenses logged by the authenticated user.

Get All Categories. GET /expenses/categories. List expense categories available in the team.

Get All Webhooks. GET /hooks. List all webhook subscriptions created with your API key.

Get Webhook. GET /hooks/{hook_id}. Retrieve a single webhook subscription.

Get All Invoices. GET /invoices. List invoices in the team. Supports filtering by date and client.

Get Invoice. GET /invoices/{invoice_id}. Retrieve a single invoice with its full line-item breakdown.

Get All Projects. GET /projects. List projects the caller has access to. Use the `query` parameter to search by name and `limit`/`page` for pagination — see Pagination.

Get Project. GET /projects/{project_id}. Retrieve a single project. See Concepts for the project model.

Get Project Fields Configuration. GET /projects/{project_id}/fields. List the custom fields configured on a project, in display order.

Get Project Sections. GET /projects/{project_id}/sections. List sections (groupings of tasks) within a project.

Get Project Tasks. GET /projects/{project_id}/tasks. List tasks in a project. By default all tasks are returned; set `exclude-closed=true` to hide closed/completed tasks. See Pagination for `limit`/`page` rules.

Search Project Tasks. GET /projects/{project_id}/tasks/search. Search tasks within a single project. Same query semantics as `GET /tasks/search`; `limit` must be between 1 and 100.

Get Project Time Records. GET /projects/{project_id}/time. List time records logged against a single project, across all users and tasks.

Get All Assignments. GET /resource-planner/assignments. List schedule assignments across the team. Supports filtering by date range, project, and member.

Get Time Off Types. GET /resource-planner/time-off-types. List the time-off types defined for the team (e.g. Vacation, Sick Leave).

Get Section. GET /sections/{section_id}. Retrieve a single section by ID.

Get Task. GET /tasks/{task_id}. Retrieve a single task with its time totals, estimate, and custom fields.

Get Task Time Records. GET /tasks/{task_id}/time. List time records logged against a single task, across all users.

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

Estimates Report (deprecated). GET /team/estimate/export. Legacy export of team estimates, returned as JSON. Requires admin access. Kept for backward compatibility; new integrations should use the dashboard reports.

Get All Time Records. GET /team/time. List time records across the entire team for a date range. When `from`/`to` are omitted, only the current day is returned. See Dates.

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

Get All Team Timers. GET /team/timers. List the timers currently running across the team — one entry per active user.

Get All Users. GET /team/users. List all members of the team. Supports `query` for name search and `limit` for pagination — see Pagination.

Get All Timecards. GET /timecards. List timecards across the team. Defaults to the last two weeks when no date range is provided — see Dates.

Get Running Timer. GET /timers/current. Retrieve the authenticated user's currently running timer, or an empty timer payload if none is running.

Get Team Timesheets. GET /timesheets. List timesheet weeks across the team, grouped by user.

Get User Time Records. GET /users/{user_id}/time. List time records for a single user. Supports the same filters as `GET /team/time`.

Get User Timecards. GET /users/{user_id}/timecards. List timecards for a single user. Defaults to the last two weeks when no date range is provided.

Get Timecard. GET /users/{user_id}/timecards/{date}. Retrieve a user's timecard for a specific date.

Get User Timesheets. GET /users/{user_id}/timesheets. List timesheet weeks for a single user. The week id is the Monday date of the week (see Dates).

Get Current User. GET /users/me. Retrieve the user that owns the API key, including personal settings (timezone, formats, API key).

Archive/Unarchive Project. PATCH /projects/{project_id}/archive. Archive or unarchive a project. Archived projects are hidden from default listings but their data is preserved.

Create Allocation. POST /allocations. Create a time-off allocation for a user and time-off type.

Create Attachment. POST /attachments. 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 Client. POST /clients. Create a new client. Names are not deduplicated — posting the same name creates another client.

Create Invoice. POST /clients/{client_id}/invoices. Create an invoice for a client. The invoice is generated from the client's tracked time over the requested date range — see Dates.

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

Add Attachment To Expense. POST /expenses/{expense_id}/attachments. Attach a previously uploaded file (by its token from `POST /attachments`) to an existing expense.

Create Category. POST /expenses/categories. Create a new expense category.

Create Webhook. POST /hooks. 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 for event types, payload structure, and delivery semantics.

Export Invoice to Xero/QB/FB. POST /invoices/{invoice_id}/export. 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.

Refresh Invoice Line Items. POST /invoices/{invoice_id}/reset-time. 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.

Create Project. POST /projects. 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 Field in Project. POST /projects/{project_id}/fields. Create a new custom field on a project.

Create Section. POST /projects/{project_id}/sections. Create a new section in a project.

Sync Integration Project. POST /projects/{project_id}/sync. 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.

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

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

Create Time Off Type. POST /resource-planner/time-off-types. Create a new time-off type.

Add Time. POST /time. 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 for accepted date and duration formats.

Start Timer. POST /timers. 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 for timer semantics.

Approve Week/Request for Approval. POST /timesheets/{timesheet_id}/approval. 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.

Clock In. POST /users/{user_id}/timecards/clock-in. Clock a user in. Starts a new timecard segment at the current time.

Clock Out. POST /users/{user_id}/timecards/clock-out. Clock a user out. Closes the current timecard segment.

Update Allocation. PUT /allocations/{allocation_id}. Update a time-off allocation's amount or period.

Update Client. PUT /clients/{client_id}. Update an existing client. Only the fields supplied in the body are modified.

Update Client Budget. PUT /clients/{client_id}/budget. Create or replace the budget attached to a client. Send a complete budget object; partial updates are not supported.

Update Expense. PUT /expenses/{expense_id}. Update an existing expense entry.

Update Category. PUT /expenses/categories/{category_id}. Update an expense category.

Update Field. PUT /fields/{field_id}. Update a custom field's name, type-specific options, or visibility.

Update Webhook. PUT /hooks/{hook_id}. 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.

Update Invoice. PUT /invoices/{invoice_id}. Update invoice metadata (notes, dates, custom totals). To change the lifecycle state, set `manualStatus` to `draft`, `sent`, or `paid`.

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

Update Project Billing/Budget. PUT /projects/{project_id}/billing. Set or update the project's budget, billable rate, and billing type in a single call. Amounts are in cents (see Concepts).

Reorder Fields. PUT /projects/{project_id}/fields-order. Reorder a project's custom fields. Send the full list of field IDs in the desired order.

Update Assignment. PUT /resource-planner/assignments/{assignment_id}. Update an existing schedule assignment.

Update Time Off Type. PUT /resource-planner/time-off-types/{type_id}. Update a time-off type's name, color, or settings.

Update Section. PUT /sections/{section_id}. Update a section's name or position.

Update Task. PUT /tasks/{task_id}. Update task fields (name, status, due date, section, labels).

Update Task Billing. PUT /tasks/{task_id}/billing. 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`.

Update Task Estimate. PUT /tasks/{task_id}/estimate. Set or replace a task's estimate (in seconds). Send a complete estimate object; partial updates are not supported.

Update Time Record. PUT /time/{time_id}. Update a specific time record by ID. To add or upsert time, use `POST /time` instead.

Approve or Reject Approval Request. PUT /timesheets/{timesheet_id}/approval. 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.

Discard Your Approval Request. PUT /timesheets/{timesheet_id}/discard-approval. Retract the caller's previously submitted approval request for a week. The week returns to draft state.

Update Timecard. PUT /users/{user_id}/timecards/{date}. 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.