Summary
Tasks - planned activities - have both a Start Date field (API name: startTime) and a Due Date field (API name: endTime)
You don't have to use both fields, but if you do, you can have a Task with a duration, rather than having only one "point in time" date
Optionally, you can set clock times as well as dates within these fields
Who is this article for?
All Planhat users
Article contents
Introduction to Tasks
"Tasks" in Planhat are also known as "planned activities". "Task" is a specific Planhat data model that's used to store/display data about activities that are due to happen in the future, or are ongoing. (Activities that have already happened are then recorded using the Conversation data model. You can read more about the relationship between these two models here.)
Tasks can be either:
External - involving your customers/prospects
E.g. a training session or a kick-off call
Internal - just involving you and your co-workers
E.g. a handover between Sales and Customer Success
Tasks can either be standalone, or part of a Workflow.
You can view Tasks in the "Calendar" Home feature, and on each Company Full-Page Profile, among other places.
There are two main types of Tasks: "Task" and "Event" (the latter being associated with calendar integrations).
In this article, we are going to focus on the "Start Date" and "Due Date" (equivalent to "End Date") fields on Tasks.
"Start Date" and "Due Date" fields
Tasks are usually scheduled for specific dates. For example, you might run a kick-off call for a new customer Company on January 1st, and then run your first training session with them on January 5th. (It is possible to have a Task without a Due Date - in the Planhat UI, this is referred to as being due "someday".)
There are actually two different Task fields related to this:
"Start Date"
API name: "startTime"
"Due Date"
API name: "endTime"
This means that Tasks can have a duration - e.g. you can set a Task to start on February 14th and end on February 16th, rather than only being associated with one specific date.
This applies to both Task types (i.e. Tasks and Events).
You don't need to use both fields for a Task if it's not necessary - you can simply set a Due Date.
π Important to note
This use of "Start Date" / "startTime" and "Due Date" / "endTime" was introduced in Q1 2026.
Prior to this:
"startTime" was the "Due Date" of Tasks
"endTime" was only used for Tasks of type "Event", and was called "End Date"
Although we have so far given the example of simple, whole-day Start Dates and Due Dates, you can actually get even more granular and add specific times, allowing you to more precisely record the duration of a Task.
To do this, when setting one of these fields, turn off the "All day" toggle switch at the top right of the calendar picker (which is on by default), and you will be able to set a time at the bottom.
π Tip
The screenshots above show an example of a Create Form for the Task model. You can customize the Task Create Form - i.e. choose which fields to show here - as described in our separate article here.
π Tip
You can't select the Start Date and Due Date fields when configuring Field Groups for a Task Preview, because the fields are automatically included near the top of Task Previews anyway.
Viewing Tasks that span a date range
The "Calendar" Home feature is a key place where you will review your own Tasks, or the Tasks of your team. You can check out our article here if you would like to learn further details about the Calendar more generally.
If you have the Calendar set up so that each lane (column) is a day/weekday, you will find that multi-day Tasks show along the top, across the relevant days, like you may be familiar with from a general calendar tool outside of Planhat.
Click the image to view it enlarged
If you click on such a Task to open up its Preview, you will see both its Start Date and Due Date (End Date equivalent) stated near the top.
Within a Company Full-Page Profile, you can customize the columns shown in the Tasks tab (shown below), to display both Start Date and Due Date.
Click the image to view it enlarged
Tasks in Workflows
Background
Planhat Workflows (formerly called Playbooks) are a series of structured steps. Tasks are one of the two main step types (the other being automatically-sent emails); Tasks are particularly relevant to the "Project" Workflow type.
You pre-configure Workflows via Workflow Templates. Workflow Templates are then applied, either manually or automatically, to relevant records (e.g. Companies), creating Workflow records and associated Tasks.
Task dates
So far in this article, we have looked at standalone Tasks, but how do Start Dates and Due Dates apply in the context of Workflows?
The Start Date (startTime) and Due Date (endTime) fields apply to all Tasks.
However, at time of writing, in a Workflow Template, you can only set "Wait For Days", which corresponds with Due Date.
Click the image to view it enlarged
Therefore, when a Workflow Template is applied and a Workflow record is created, the associated Tasks are only automatically assigned a Due Date. Nonetheless, you can still manually set the Start Date on Tasks that are part of Workflows.
In a future release, you will be able to configure both Start Date and Due Date directly from Workflow Templates.








