Create a time entry

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

Headers

application/json

Body Required

  • trackable_type string Required

    The type of the model that is being tracked.. Valid types are: client, board_task, case, circle, firm, task

  • trackable_uuid string 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 date

    The start time of the time entry.

  • end_date 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
POST /api/v1/time-entry 
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/time-entry' \
 --header "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 --header "Content-Type: application/json" \
 --header "Accept: application/json" \
 --data '{"trackable_type":"Client","trackable_uuid":"c85d7e72-bb7f-420d-99f2-c792f5025650","name":"Research","description":"Research for the new project.","start_date":"2025-04-22T12:59:19+01:00","end_date":"2025-04-22T13:44:19+01:00","total_time_in_minutes":200}'
Request examples 
# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json

# Payload
{
  "trackable_type": "Client",
  "trackable_uuid": "c85d7e72-bb7f-420d-99f2-c792f5025650",
  "name": "Research",
  "description": "Research for the new project.",
  "start_date": "2025-04-22T12:59:19+01:00",
  "end_date": "2025-04-22T13:44:19+01:00",
  "total_time_in_minutes": 200
}
Response examples (200) 
{
  "name": "Research",
  "uuid": "ea3d4da0-6634-4b7e-9299-4965a4952dff",
  "account": {
    "name": "Gareth Thompson",
    "role": "client",
    "type": "client",
    "uuid": "5a100936-1238-433c-8749-87cfa4fbe054",
    "email": "gareth@codepotato.co.uk",
    "last_name": "Thompson",
    "photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
    "created_at": "2025-04-22T13:44:19+01:00",
    "first_name": "Gareth",
    "updated_at": "2025-04-22T13:44:19+01:00",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "end_date": "2025-04-22T13:22:19+01:00",
  "is_active": true,
  "trackable": {
    "name": "Gareth Thompson",
    "role": "client",
    "type": "client",
    "uuid": "a55eb628-dae6-47e2-b035-f2b7f4ebeab4",
    "email": "gareth@codepotato.co.uk",
    "last_name": "Thompson",
    "photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
    "created_at": "2025-04-22T13:44:19+01:00",
    "first_name": "Gareth",
    "updated_at": "2025-04-22T13:44:19+01:00",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "created_at": "2025-04-22T13:44:19+01:00",
  "start_date": "2025-04-22T12:54:19+01:00",
  "updated_at": "2025-04-22T13:44:19+01:00",
  "description": "This is a description.",
  "trackable_type": "Client",
  "total_time_in_minutes": 28,
  "computed_time_elapsed_in_seconds": 1680
}