POST /api/v1/time-entry
Personal access token & O auth2
application/json

Body

  • trackable_type string Required

    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, or task.

  • trackable_uuid string(uuid) Required

    The UUID of the model that is being tracked

  • name string Required

    The name of the time entry.

  • description string

    The description of the time entry.

  • start_date string(date)

    The start time of the time entry.

  • end_date string(date)

    The end time of the time entry.

  • total_time_in_minutes integer

    The length of the time entry, can be used instead of dates.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • uuid string

      The UUID of the resource.

    • created_at string

      The timestamp of when the resource was created.

    • updated_at string

      The timestamp of when the resource was updated.

    • name string

      The name of the time entry.

    • description string

      The description of the time entry.

    • trackable_type string

      The model type that is being tracked. The example given is a client, but it can be a case, firm, circle or task.

    • trackable object

      The model that is being tracked. The example given is a client, but it can be a case, firm, or task.

      Hide trackable attributes Show trackable attributes object
      • uuid string
      • created_at string
      • updated_at string
      • type string
      • role string
      • first_name string
      • last_name string
      • name string
      • email string
      • photo_url string
      • external_references string
    • start_date string

      The start time of the time entry.

    • end_date string

      The end time of the time entry.

    • is_active boolean

      Determines if the time entry is currently ongoing.

    • total_time_in_minutes integer

      Total time in minutes.

    • computed_time_elapsed_in_seconds integer

      Computed time elapsed in seconds.

    • account object

      Who started the timer.

      Hide account attributes Show account attributes object
      • uuid string
      • created_at string
      • updated_at string
      • type string
      • role string
      • first_name string
      • last_name string
      • name string
      • email string
      • photo_url string
      • external_references string
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":"ed1b81d0-f0f0-453b-ad94-8bc4f780535c","name":"Research","description":"Research for the new project.","start_date":"2026-04-04","end_date":"2026-05-19","total_time_in_minutes":200}'
Request examples 
{
  "trackable_type": "client",
  "trackable_uuid": "ed1b81d0-f0f0-453b-ad94-8bc4f780535c",
  "name": "Research",
  "description": "Research for the new project.",
  "start_date": "2026-04-04",
  "end_date": "2026-05-19",
  "total_time_in_minutes": 200
}
Response examples (200) 
{
  "uuid": "cf75e1fc-4d55-4c37-8646-269da77a4cf9",
  "created_at": "2026-05-19T18:31:17+01:00",
  "updated_at": "2026-05-19T18:31:17+01:00",
  "name": "Research",
  "description": "This is a description.",
  "trackable_type": "Client",
  "trackable": {
    "uuid": "d5fe9e6a-78cc-4cc8-b819-5c32457e612e",
    "created_at": "2026-05-19T18:31:17+01:00",
    "updated_at": "2026-05-19T18:31:17+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": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "start_date": "2026-05-19T17:41:17+01:00",
  "end_date": "2026-05-19T18:09:17+01:00",
  "is_active": true,
  "total_time_in_minutes": 28,
  "computed_time_elapsed_in_seconds": 1680,
  "account": {
    "uuid": "53eb7bf8-b8aa-425b-97c0-ae03064b9e21",
    "created_at": "2026-05-19T18:31:17+01:00",
    "updated_at": "2026-05-19T18:31:17+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": "App\\Http\\Resources\\ExternalReferenceResource"
  }
}