Skip to main content

Task "Start Date" and "Due Date"

Tasks can have a duration - with a start time and end time - rather than just being a "single point in time" activity

Written by Carly Hammond
Updated today

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.

Did this answer your question?