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": "39eb01c4-a025-4e40-8c9c-88030408d740",
"name": "Research",
"description": "Research for the new project.",
"start_date": "2026-08-03",
"end_date": "2026-09-17",
"total_time_in_minutes": 200
}'
Request examples
{
"trackable_type": "client",
"trackable_uuid": "39eb01c4-a025-4e40-8c9c-88030408d740",
"name": "Research",
"description": "Research for the new project.",
"start_date": "2026-08-03",
"end_date": "2026-09-17",
"total_time_in_minutes": 200
}
Response examples (200)
{
"uuid": "2b88b673-e695-4a0f-b56c-ff1a6490e520",
"created_at": "2026-09-17T15:10:59+01:00",
"updated_at": "2026-09-17T15:10:59+01:00",
"name": "Research",
"description": "This is a description.",
"trackable_type": "Client",
"trackable": {
"uuid": "d915e15d-466c-48ae-8301-bc9fca3ed621",
"created_at": "2026-09-17T15:10:59+01:00",
"updated_at": "2026-09-17T15:10:59+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": "eed66603-e4be-4584-bc91-6f9a5c327f4b",
"created_at": "2026-09-17T15:11:06+01:00",
"updated_at": "2026-09-17T15:11:06+01:00",
"third_party": "nucleus",
"reference": "AB123456"
}
},
"start_date": "2026-09-17T14:20:59+01:00",
"end_date": "2026-09-17T14:48:59+01:00",
"is_active": true,
"total_time_in_minutes": 28,
"computed_time_elapsed_in_seconds": 1680,
"account": {
"uuid": "1945e361-48b9-4207-9279-c87159f8cce4",
"created_at": "2026-09-17T15:10:59+01:00",
"updated_at": "2026-09-17T15:10:59+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": "eed66603-e4be-4584-bc91-6f9a5c327f4b",
"created_at": "2026-09-17T15:11:06+01:00",
"updated_at": "2026-09-17T15:11:06+01:00",
"third_party": "nucleus",
"reference": "AB123456"
}
}
}
Response examples (422)
{
"message": "The given data was invalid.",
"errors": {
"field": [
"The field is invalid."
]
}
}