Skip to main content
POST
/
projects
/
{id}
/
time-entries
Create a time entry
curl --request POST \
  --url https://api.corebill.io/v1/projects/{id}/time-entries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entry_date": "2025-04-10",
  "duration_minutes": 480,
  "hourly_rate": 75,
  "task_id": "tsk_a1b2c3d4e5f6",
  "description": "Implemented responsive navigation",
  "is_billable": true,
  "internal_cost_rate": 37.5,
  "metadata": {}
}
'
{
  "data": {
    "id": "tme_a1b2c3d4e5f6",
    "project_id": "pro_a1b2c3d4e5f6",
    "task_id": "tsk_a1b2c3d4e5f6",
    "user_id": "usr_abc123",
    "company_id": "com_a1b2c3d4e5f6",
    "start_time": "2025-04-10T09:00:00Z",
    "end_time": "2025-04-10T17:00:00Z",
    "duration_minutes": 480,
    "is_running": false,
    "description": "Implemented responsive navigation",
    "is_billable": true,
    "hourly_rate": 75,
    "internal_cost_rate": 123,
    "invoiced": false,
    "invoice_id": "<string>",
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Generate keys from the Corebill dashboard under the Developers section.

Example: Authorization: Bearer sk_live_abc123def456

Path Parameters

​
id
string
required

The project ID

Query Parameters

​
company_id
string
required

The company ID to scope the request to

Body

application/json
​
entry_date
string<date>
required

Date of the time entry

Example:

"2025-04-10"

​
duration_minutes
integer
required

Duration in minutes (must be > 0)

Required range: x >= 1
Example:

480

​
hourly_rate
number<double>
required

Hourly rate (must be >= 0)

Required range: x >= 0
Example:

75

​
task_id
string

Associate with a specific task

Example:

"tsk_a1b2c3d4e5f6"

​
description
string

Description of work performed

Example:

"Implemented responsive navigation"

​
is_billable
boolean

Whether this entry is billable (defaults to true)

Example:

true

​
internal_cost_rate
number<double>

Internal cost rate for profit tracking

Example:

37.5

​
metadata
object

Response

Time entry created

​
data
object
required

Time entry object