Create a Task
The task is the basic building block in SmartTask. In the SmartTask application, middle pane is populated with tasks. When a task is selected, it opens up the right hand side detailed pane with selected task's parameters.
Create a Task
POST https://ext-v2.smarttask.io/v{api-version}/task/create-task/{organization_id}
Path Parameters
Name
Type
Description
api-version
string
API Version - 1.0
organization_id
number
OrganizationId of SmartTask organization
Headers
Name
Type
Description
Authorization
string
Authorization Bearer token
Request Body
Please refer to Task
Response
{
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"organization_id": 38,
"created_by_user_id": 57,
"record_type": "task",
"record_sub_type": "task",
"access_type": "default",
"is_template": false,
"name": "John doe enterprises",
"description": "<p><strong>Industry:</strong> Technology (Software Development & IT Services)</p><p><strong>Headquarters:</strong> San Francisco, CA, USA</p><h3><strong>Business Objectives:</strong></h3><ul><li><p><strong>Primary Goal:</strong> Increase brand awareness and online presence for their newly launched software product, CloudX.</p></li><li><p><strong>Secondary Goal:</strong> Generate qualified leads for B2B sales and improve customer engagement through digital channels.</p></li></ul><p></p>",
"parents": [],
"assigned_user": {
"email_confirmed": true,
"role": "core",
"job_role": null,
"department": null,
"about_me": null,
"status_icon_url": null,
"status_message": null,
"status_out_of_office": false,
"status_clear_at": null,
"cost_per_hour": 50.0,
"billable_rate_per_hour": 100.0,
"capacity": {
"mon_capacity_in_hours": 8,
"tue_capacity_in_hours": 8,
"wed_capacity_in_hours": 8,
"thu_capacity_in_hours": 8,
"fri_capacity_in_hours": 8,
"sat_capacity_in_hours": 0,
"sun_capacity_in_hours": 0,
"weekly_capacity_in_hours": 40
},
"created_at": "2025-05-01T13:57:03.2503853Z",
"modified_at": "2025-05-01T13:57:03.2503853Z",
"user_id": 56,
"full_name": "Olivia Jones",
"email": "olivia@acme.io",
"avatar_url": "https://smartstorage1.blob.core.windows.net/photos/UserPics/5b1f69da-9d5e-404e-b2b9-14f5c2c85bf6.png",
"timezone_in_mins": null
},
"followers": [
{
"email_confirmed": true,
"role": "core",
"job_role": null,
"department": null,
"about_me": null,
"status_icon_url": null,
"status_message": null,
"status_out_of_office": false,
"status_clear_at": null,
"cost_per_hour": 50.0,
"billable_rate_per_hour": 100.0,
"capacity": {
"mon_capacity_in_hours": 8,
"tue_capacity_in_hours": 8,
"wed_capacity_in_hours": 8,
"thu_capacity_in_hours": 8,
"fri_capacity_in_hours": 8,
"sat_capacity_in_hours": 0,
"sun_capacity_in_hours": 0,
"weekly_capacity_in_hours": 40
},
"created_at": "2025-05-01T13:57:03.2505218Z",
"modified_at": "2025-05-01T13:57:03.2505218Z",
"user_id": 56,
"full_name": "Olivia Jones",
"email": "olivia@acme.io",
"avatar_url": "https://smartstorage1.blob.core.windows.net/photos/UserPics/5b1f69da-9d5e-404e-b2b9-14f5c2c85bf6.png",
"timezone_in_mins": null
},
{
"email_confirmed": true,
"role": "core",
"job_role": null,
"department": null,
"about_me": null,
"status_icon_url": null,
"status_message": null,
"status_out_of_office": false,
"status_clear_at": null,
"cost_per_hour": 50.0,
"billable_rate_per_hour": 100.0,
"capacity": {
"mon_capacity_in_hours": 8,
"tue_capacity_in_hours": 8,
"wed_capacity_in_hours": 8,
"thu_capacity_in_hours": 8,
"fri_capacity_in_hours": 8,
"sat_capacity_in_hours": 0,
"sun_capacity_in_hours": 0,
"weekly_capacity_in_hours": 40
},
"created_at": "2025-05-01T13:57:03.2505293Z",
"modified_at": "2025-05-01T13:57:03.2505294Z",
"user_id": 57,
"full_name": "Mike Williams",
"email": "mike@acme.io",
"avatar_url": "https://smartstorage1.blob.core.windows.net/smarttask/organization/26/0303cfa3-ebce-4928-8e03-df260ec17686/mike.webp",
"timezone_in_mins": null
}
],
"custom_field_values": [
{
"custom_field_info": {
"custom_field_id": "1b3e66f3-8fa4-47ca-8034-523665394c61",
"type": "select",
"data_type": "select",
"name": "Qualified Lead",
"last_custom_id": null,
"config_editable_by": "everyone",
"value_editable_by": "everyone",
"created_at": "2025-05-01T13:57:03.2505709Z",
"modified_at": "2025-05-01T13:57:03.250571Z"
},
"option_value": {
"option_id": "7b1f4034-ec94-40e4-87db-60aa18987e48",
"custom_field_id": "1b3e66f3-8fa4-47ca-8034-523665394c61",
"name": "Yes",
"color_id": 13,
"is_enabled": true,
"order_index": 148.000000000000000,
"created_at": "2024-11-13T12:47:19.1032711",
"modified_at": "2024-11-13T12:47:19.1032745"
},
"multi_select_option_values": [],
"created_at": "2025-05-01T13:57:03.2505412Z",
"modified_at": "0001-01-01T00:00:00",
"cfv_id": 438511,
"project_id": null,
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"custom_field_id": "1b3e66f3-8fa4-47ca-8034-523665394c61",
"text_value": null,
"number_value": null,
"option_id": "7b1f4034-ec94-40e4-87db-60aa18987e48",
"option_multiple_ids": [],
"datetime_value": null
},
{
"custom_field_info": {
"custom_field_id": "ce04759b-604b-44cb-95e9-e62846ad66fc",
"type": "select",
"data_type": "select",
"name": "Service Interested",
"last_custom_id": null,
"missing_dependency": false,
"config_editable_by": "everyone",
"value_editable_by": "everyone",
"created_at": "2025-05-01T13:57:03.2506153Z",
"modified_at": "2025-05-01T13:57:03.2506153Z"
},
"option_value": {
"option_id": "bb5730ce-7227-4ea7-bbcf-41bd10a8e026",
"custom_field_id": "ce04759b-604b-44cb-95e9-e62846ad66fc",
"name": "Social media management",
"color_id": 12,
"is_enabled": true,
"order_index": 926.000000000000000,
"created_at": "2024-11-13T12:51:10.218605",
"modified_at": "2024-11-13T12:51:10.218617"
},
"multi_select_option_values": [],
"created_at": "2025-05-01T13:57:03.2506124Z",
"modified_at": "0001-01-01T00:00:00",
"cfv_id": 438520,
"project_id": null,
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"custom_field_id": "ce04759b-604b-44cb-95e9-e62846ad66fc",
"text_value": null,
"number_value": null,
"option_id": "bb5730ce-7227-4ea7-bbcf-41bd10a8e026",
"option_multiple_ids": [],
"datetime_value": null
},
{
"custom_field_info": {
"custom_field_id": "3b22221d-188b-4761-a27f-39cb24e2b7c6",
"type": "select",
"data_type": "select",
"name": "Request Type",
"last_custom_id": null,
"missing_dependency": false,
"config_editable_by": "everyone",
"value_editable_by": "everyone",
"created_at": "2025-05-01T13:57:03.2506294Z",
"modified_at": "2025-05-01T13:57:03.2506295Z"
},
"option_value": {
"option_id": "ae2fa8fe-7abb-4fd1-98f7-b744e40df3eb",
"custom_field_id": "3b22221d-188b-4761-a27f-39cb24e2b7c6",
"name": "Organization",
"color_id": 10,
"is_enabled": true,
"order_index": 165.000000000000000,
"created_at": "2024-11-14T06:32:31.4777778",
"modified_at": "2024-11-14T06:36:51.1292097"
},
"multi_select_option_values": [],
"created_at": "2025-05-01T13:57:03.2506271Z",
"modified_at": "0001-01-01T00:00:00",
"cfv_id": 439307,
"project_id": null,
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"custom_field_id": "3b22221d-188b-4761-a27f-39cb24e2b7c6",
"text_value": null,
"number_value": null,
"option_id": "ae2fa8fe-7abb-4fd1-98f7-b744e40df3eb",
"option_multiple_ids": [],
"datetime_value": null
},
{
"custom_field_info": {
"custom_field_id": "07b35e2c-8d9a-4233-9139-56940d8e0316",
"type": "select",
"data_type": "select",
"name": "Status",
"last_custom_id": null,
"missing_dependency": false,
"config_editable_by": "everyone",
"value_editable_by": "everyone",
"created_at": "2025-05-01T13:57:03.2506428Z",
"modified_at": "2025-05-01T13:57:03.2506429Z"
},
"option_value": {
"option_id": "59fd631c-7527-4a2b-925e-43f2a927e2fd",
"custom_field_id": "07b35e2c-8d9a-4233-9139-56940d8e0316",
"name": "Not started",
"color_id": 3,
"is_enabled": true,
"order_index": 1.000000000000000,
"created_at": "2024-11-08T06:53:30.551784",
"modified_at": "2025-03-26T12:32:56.4482762"
},
"multi_select_option_values": [],
"created_at": "2025-05-01T13:57:03.2506405Z",
"modified_at": "0001-01-01T00:00:00",
"cfv_id": 439314,
"project_id": null,
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"custom_field_id": "07b35e2c-8d9a-4233-9139-56940d8e0316",
"text_value": null,
"number_value": null,
"option_id": "59fd631c-7527-4a2b-925e-43f2a927e2fd",
"option_multiple_ids": [],
"datetime_value": null
},
{
"custom_field_info": {
"custom_field_id": "d97545d8-837b-4971-bcd6-63f6834cd826",
"type": "select",
"data_type": "select",
"name": "Region",
"last_custom_id": null,
"missing_dependency": false,
"config_editable_by": "everyone",
"value_editable_by": "everyone",
"created_at": "2025-05-01T13:57:03.2506579Z",
"modified_at": "2025-05-01T13:57:03.250658Z"
},
"option_value": null,
"multi_select_option_values": [],
"created_at": "2025-05-01T13:57:03.2506556Z",
"modified_at": "0001-01-01T00:00:00",
"cfv_id": 668534,
"project_id": null,
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"custom_field_id": "d97545d8-837b-4971-bcd6-63f6834cd826",
"text_value": null,
"number_value": null,
"option_id": null,
"option_multiple_ids": [],
"datetime_value": null
},
{
"custom_field_info": {
"custom_field_id": "d1564388-eac1-4ab2-8d9f-45aabaea684e",
"type": "select",
"data_type": "select",
"name": "Lead Source",
"last_custom_id": null,
"missing_dependency": false,
"config_editable_by": "everyone",
"value_editable_by": "everyone",
"created_at": "2025-05-01T13:57:03.2506669Z",
"modified_at": "2025-05-01T13:57:03.2506669Z"
},
"option_value": null,
"multi_select_option_values": [],
"created_at": "2025-05-01T13:57:03.2506648Z",
"modified_at": "0001-01-01T00:00:00",
"cfv_id": 3243924,
"project_id": null,
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"custom_field_id": "d1564388-eac1-4ab2-8d9f-45aabaea684e",
"text_value": null,
"number_value": null,
"option_id": null,
"option_multiple_ids": [],
"datetime_value": null
},
{
"custom_field_info": {
"custom_field_id": "67aa8914-ef12-4f58-b1ac-add2208afa49",
"type": "select",
"data_type": "select",
"name": "Demo Done",
"last_custom_id": null,
"missing_dependency": false,
"config_editable_by": "everyone",
"value_editable_by": "everyone",
"created_at": "2025-05-01T13:57:03.2506756Z",
"modified_at": "2025-05-01T13:57:03.2506756Z"
},
"option_value": null,
"multi_select_option_values": [],
"created_at": "2025-05-01T13:57:03.2506734Z",
"modified_at": "0001-01-01T00:00:00",
"cfv_id": 3243925,
"project_id": null,
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"custom_field_id": "67aa8914-ef12-4f58-b1ac-add2208afa49",
"text_value": null,
"number_value": null,
"option_id": null,
"option_multiple_ids": [],
"datetime_value": null
},
{
"custom_field_info": {
"custom_field_id": "9cbefca1-61dd-488b-969e-bcb347b47e47",
"type": "select",
"data_type": "select",
"name": "Deal Stage",
"last_custom_id": null,
"missing_dependency": false,
"config_editable_by": "everyone",
"value_editable_by": "everyone",
"created_at": "2025-05-01T13:57:03.2506849Z",
"modified_at": "2025-05-01T13:57:03.2506849Z"
},
"option_value": {
"option_id": "0c0f54c0-bc85-4f00-800f-33f8a9858f86",
"custom_field_id": "9cbefca1-61dd-488b-969e-bcb347b47e47",
"name": "Deal Won",
"color_id": 7,
"is_enabled": true,
"order_index": 898.000000000000000,
"created_at": "2024-11-13T12:39:29.0288334",
"modified_at": "2025-04-09T19:41:54.5213358"
},
"multi_select_option_values": [],
"created_at": "2025-05-01T13:57:03.2506826Z",
"modified_at": "0001-01-01T00:00:00",
"cfv_id": 3243926,
"project_id": null,
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"custom_field_id": "9cbefca1-61dd-488b-969e-bcb347b47e47",
"text_value": null,
"number_value": null,
"option_id": "0c0f54c0-bc85-4f00-800f-33f8a9858f86",
"option_multiple_ids": [],
"datetime_value": null
},
{
"custom_field_info": {
"custom_field_id": "3413b8d2-b80c-4a35-b286-c51f4be85a2e",
"type": "select",
"data_type": "select",
"name": "Vertical",
"last_custom_id": null,
"missing_dependency": false,
"config_editable_by": "everyone",
"value_editable_by": "everyone",
"created_at": "2025-05-01T13:57:03.2507002Z",
"modified_at": "2025-05-01T13:57:03.2507002Z"
},
"option_value": null,
"multi_select_option_values": [],
"created_at": "2025-05-01T13:57:03.250698Z",
"modified_at": "0001-01-01T00:00:00",
"cfv_id": 3243927,
"project_id": null,
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"custom_field_id": "3413b8d2-b80c-4a35-b286-c51f4be85a2e",
"text_value": null,
"number_value": null,
"option_id": null,
"option_multiple_ids": [],
"datetime_value": null
},
{
"custom_field_info": {
"custom_field_id": "2865eca7-ad10-41d9-abb2-f75cecfd344a",
"type": "number",
"data_type": "number",
"name": "Payment Value",
"last_custom_id": null,
"missing_dependency": false,
"config_editable_by": "everyone",
"value_editable_by": "everyone",
"created_at": "2025-05-01T13:57:03.2507099Z",
"modified_at": "2025-05-01T13:57:03.25071Z"
},
"option_value": null,
"multi_select_option_values": [],
"created_at": "2025-05-01T13:57:03.2507075Z",
"modified_at": "0001-01-01T00:00:00",
"cfv_id": 3243928,
"project_id": null,
"record_id": "1d6f7da6-45bf-4ef1-a55a-265b30aa2484",
"custom_field_id": "2865eca7-ad10-41d9-abb2-f75cecfd344a",
"text_value": null,
"number_value": 15000.00000,
"option_id": null,
"option_multiple_ids": [],
"datetime_value": null
}
],
"reminders": [],
"priority": "high",
"date_info": {
"start_date": "2024-11-05T18:30:00",
"due_date": "2024-11-06T18:29:00",
"duration": 1,
"recurr_type": "never_repeat",
"recurr_on": "on_completion",
"recurr_interval": 1,
"recurr_weekdays": [],
"recurr_day_of_month": 1,
"recurr_on_start_date": null,
"recurring_record_created": false
},
"planned_start": null,
"planned_due": null,
"status": 1,
"status_modified_at": "2025-04-23T08:30:24.836",
"completed_at": "2025-04-23T08:30:24.836",
"estimated_time": 233,
"actual_time": null,
"billable": true,
"cost": null,
"billable_amount": null,
"parent": null,
"member_role": "edit",
"archived": false,
"projects": [
{
"inherited": false,
"group_id": 124,
"project_id": "2b928aec-ca9c-4ed3-80c5-24523c2f7b8e",
"parent_project_id": null,
"name": "Deals",
"data_type": "task",
"access_type": "public_to_parent",
"default_view_id": "c555b969-5e01-46f7-a477-032acbdaaa62",
"start_date": null,
"due_date": null,
"icon_url": "https://v2.smarttask.io/assets/images/common/svg/icons/8.svg",
"color_id": 15,
"order_index": 9.500000000000000,
"owner_user_id": 57,
"status": null,
"is_template": false,
"t_record_dates_from": null,
"archived": false,
"is_delete_triggered": false,
"created_at": "2024-11-08T06:26:10.473"
}
],
"files": [],
"dependencies": [],
"contacts": [
{
"record_id": "173b2b1c-8738-4d50-8f3b-51aad190014e",
"record_sub_type": "person",
"name": "John",
"avatar_url": null,
"parent_name": null,
"designation": null,
"archived": false
}
],
"contact_email": null,
"contact_phone": null,
"created_at": "2024-11-13T12:31:07.367",
"modified_at": "2025-04-23T13:02:15.703",
}Last updated