---
schema_version: "1"
id: 168513eb7e0f339ac5731b83604bdfeabcc7eedaa92ef0b3f4bc7334e19b7824
title: CareTask
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/sforce_api_objects_caretask.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_objects_caretask.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: dd0f8ffecbeb95cd80b6e2f75de2d792570ed44c3946ff3da6bd647c56868cb5
description: Represents additional information about a healthcare-related task such as process status, beneficiary, and related tasks. This object is available in API version 61.0 and later.
---
# CareTask

Represents additional information about a healthcare-related task such as process status, beneficiary, and related tasks. This object is available in API version 61.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

## Fields

### ActionCodeId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: A name or code that describes the task.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: ActionCode
- **Relationship Type**: Lookup
- **Refers To**: CodeSet, CodeSetBundle

### ActualEndDate

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date when the task ends.

### ActualStartDate

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date when the task starts.

### BeneficiaryId

- **Type**: reference
- **Properties**: Create, Filter, Group, Sort, Update
- **Description**: The party who benefits from the task.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: Beneficiary
- **Relationship Type**: Lookup
- **Refers To**: Account, HealthcareProvider

### ClinicalEncounterId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The associated clinical encounter for which the task was created.
    
    This field is a relationship field.
- **Relationship Name**: ClinicalEncounter
- **Relationship Type**: Lookup
- **Refers To**: ClinicalEncounter

### ContentResource

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Stores the endpoints or URLs to relevant educational resources such as PDFs.

### ExpectedEndDate

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date when the task is expected to end.

### ExpectedStartDate

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date when the task is expected to start.

### ExtlTaskDefIdentifier

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The ID or URL of the external task definition in the source system.

### GroupIdentifier

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The shared ID of multiple independent tasks.

### LastReferencedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The most recent date on which a user referenced the record.

### LastViewedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The most recent date on which a user viewed the record.

### LocationId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The location where the task is performed.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: Location
- **Relationship Type**: Lookup
- **Refers To**: HealthcareFacility, Location

### Name

- **Type**: string
- **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort
- **Description**: The name of the care task record.

### OwnedById

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The party who's responsible for executing the task.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: OwnedBy
- **Relationship Type**: Lookup
- **Refers To**: Account, CareRegisteredDevice, Contact, User

### OwnerId

- **Type**: reference
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: The owner of the care task record.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: Owner
- **Relationship Type**: Lookup
- **Refers To**: Group, User

### ParentCareTaskId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The associated care task.
    
    This field is a relationship field.
- **Relationship Name**: ParentCareTask
- **Relationship Type**: Lookup
- **Refers To**: CareTask

### ProcessStatusId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The business-specific process status of the task.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: ProcessStatus
- **Relationship Type**: Lookup
- **Refers To**: CodeSet, CodeSetBundle

### RequestedById

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The party who created the task.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: RequestedBy
- **Relationship Type**: Lookup
- **Refers To**: Account, CareRegisteredDevice, Contact, HealthcareProvider, User

### SequenceNumber

- **Type**: int
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The sequence number in which the task is performed.

### ShouldIgnore

- **Type**: boolean
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: Indicates if the action specified in the task should be ignored or performed.
- **Default value**: false

### SourceSystemIdentifier

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The ID of the record in the external source system.

### SourceSystemModifiedDateTime

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date and time when the record was last modified in the external source system.

### SourceSystemName

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The name of the external source system from which the record was imported.

### StatusReason

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The reason for the status of the task.

### TaskId

- **Type**: reference
- **Properties**: Create, Filter, Group, Sort, Update
- **Description**: The task associated with the care task.
    
    This field is a relationship field.
- **Relationship Name**: Task
- **Relationship Type**: Lookup
- **Refers To**: Task

## Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

[CareTaskChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_change_event.htm "A StandardObjectNameChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.")

Change events are available for the object.

[CareTaskFeed](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")

Feed tracking is available for the object.

[CareTaskHistory](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.")

History is available for tracked fields of the object.

[CareTaskShare](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.")

Sharing is available for the object.