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":"668eee6d-7bae-46e5-9de1-2dafaf45aa95","name":"Research","description":"Research for the new project.","start_date":"2026-06-23","end_date":"2026-08-07","total_time_in_minutes":200}'
Request examples
{
"trackable_type": "client",
"trackable_uuid": "668eee6d-7bae-46e5-9de1-2dafaf45aa95",
"name": "Research",
"description": "Research for the new project.",
"start_date": "2026-06-23",
"end_date": "2026-08-07",
"total_time_in_minutes": 200
}
Response examples (200)
{
"uuid": "b6f660cf-f01e-45b8-9653-fc71d2ebc952",
"created_at": "2026-08-07T15:29:24+01:00",
"updated_at": "2026-08-07T15:29:24+01:00",
"name": "Research",
"description": "This is a description.",
"trackable_type": "Client",
"trackable": {
"uuid": "feab3352-6927-4f64-8232-fb4ffbee2e3b",
"created_at": "2026-08-07T15:29:24+01:00",
"updated_at": "2026-08-07T15:29:24+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": "2244294c-23fd-429a-b952-64a6fc469ad4",
"created_at": "2026-08-07T15:29:31+01:00",
"updated_at": "2026-08-07T15:29:31+01:00",
"third_party": "nucleus",
"reference": "AB123456"
}
},
"start_date": "2026-08-07T14:39:24+01:00",
"end_date": "2026-08-07T15:07:24+01:00",
"is_active": true,
"total_time_in_minutes": 28,
"computed_time_elapsed_in_seconds": 1680,
"account": {
"uuid": "e36fc791-864f-4b97-b504-23990a7c826e",
"created_at": "2026-08-07T15:29:24+01:00",
"updated_at": "2026-08-07T15:29:24+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": "2244294c-23fd-429a-b952-64a6fc469ad4",
"created_at": "2026-08-07T15:29:31+01:00",
"updated_at": "2026-08-07T15:29:31+01:00",
"third_party": "nucleus",
"reference": "AB123456"
}
}
}
Response examples (422)
{
"message": "The given data was invalid.",
"errors": {
"field": [
"The field is invalid."
]
}
}