Create a time entry Run in API Explorer
Ask AI
Body
-
The type of the model that is being tracked.. Valid types are: client, board_task, case, circle, firm, task
Values are
client,board_task,case,circle,firm, ortask. -
The UUID of the model that is being tracked
-
The name of the time entry.
-
The description of the time entry.
-
The start time of the time entry.
-
The end time of the time entry.
-
The length of the time entry, can be used instead of dates.
POST
/api/v1/time-entry
curl \
--request POST 'https://api.plannrcrm.com/api/v1/time-entry' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"trackable_type":"client","trackable_uuid":"794dad6e-915f-411d-b8ae-e1a1c3b3cf6e","name":"Research","description":"Research for the new project.","start_date":"2026-07-14","end_date":"2026-08-28","total_time_in_minutes":200}'
Request examples
{
"trackable_type": "client",
"trackable_uuid": "794dad6e-915f-411d-b8ae-e1a1c3b3cf6e",
"name": "Research",
"description": "Research for the new project.",
"start_date": "2026-07-14",
"end_date": "2026-08-28",
"total_time_in_minutes": 200
}
Response examples (200)
{
"uuid": "5d3f9beb-02a9-444d-9a13-805b55a24786",
"created_at": "2026-08-28T07:34:58+01:00",
"updated_at": "2026-08-28T07:34:58+01:00",
"name": "Research",
"description": "This is a description.",
"trackable_type": "Client",
"trackable": {
"uuid": "3fcc4d8c-06a3-4df3-b830-35183af35dce",
"created_at": "2026-08-28T07:34:58+01:00",
"updated_at": "2026-08-28T07:34:58+01:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
"external_references": {
"uuid": "bbebe1dc-bcfb-4078-848e-1293b8f6887d",
"created_at": "2026-08-28T07:35:05+01:00",
"updated_at": "2026-08-28T07:35:05+01:00",
"third_party": "nucleus",
"reference": "AB123456"
}
},
"start_date": "2026-08-28T06:44:58+01:00",
"end_date": "2026-08-28T07:12:58+01:00",
"is_active": true,
"total_time_in_minutes": 28,
"computed_time_elapsed_in_seconds": 1680,
"account": {
"uuid": "aebf5ee0-69af-4a84-b230-d2e596195df9",
"created_at": "2026-08-28T07:34:58+01:00",
"updated_at": "2026-08-28T07:34:58+01:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
"external_references": {
"uuid": "bbebe1dc-bcfb-4078-848e-1293b8f6887d",
"created_at": "2026-08-28T07:35:05+01:00",
"updated_at": "2026-08-28T07:35:05+01:00",
"third_party": "nucleus",
"reference": "AB123456"
}
}
}
Response examples (422)
{
"message": "The given data was invalid.",
"errors": {
"field": [
"The field is invalid."
]
}
}