MCP Server for HubSpot

Build 24.0.9300

EngagementsTasks

Lists all task engagement records in HubSpot for managing CRM-related tasks.

SELECT

When selecting Task Engagements, filtering can be applied to columns marked as "Filterable." For these columns, the supported server-side operator is =. 

SELECT * FROM EngagementsTasks WHERE ID = '96ec8565-3b73-4ee8-9815-f90566ba9c42';
SELECT * FROM EngagementsTasks WHERE Archived = TRUE;

INSERT


INSERT INTO EngagementsTasks ([Task title], [Task notes], [Task status], [Task type], [Activity date])
VALUES ('Test Task Title', 'Body of the task', 'IN_PROGRESS', 'LINKED_IN_MESSAGE', current_timestamp())

UPDATE


UPDATE EngagementsTasks SET [Task notes] = 'Updated Task body test', [Task status] = 'COMPLETED' WHERE ID = '11896363224'

DELETE


DELETE FROM EngagementsTasks WHERE ID = '11896363224'

Columns

Name Type ReadOnly References Filterable Description
Id [KEY] Long False True

Unique identifier of the object.

Archived Bool True True

Whether the object is archived or not.

CreatedAt Datetime True False

When the object was created.

UpdatedAt Datetime True False

When the object was last updated.

Business units String False False

The business units this record is assigned to.

AtMentioned Owner Ids String False False

The owners that have been at_mentioned on the engagement.

Attached file IDs String False False

The IDs of the files that are attached to the engagement.

Notes _preview_ String True False

A plain_text preview of the notes field on a task.

HTML Body Preview String True False

The HTML representation of the engagement body preview.

Body Preview Truncated Bool True False

Indicates whether the engagement body was truncated for the preview.

Calendar Event ID String True False

The event ID for the synced task.

Created by Decimal True False

The user who created the engagement.

Created by user ID Decimal True False

The user that created this object. This value is automatically set by HubSpot and may not be modified.

Created at Datetime True False

The date that an engagement was created.

Source String False False

The source that created this engagement.

Source ID String False False

The specific ID of the process that created this engagement.

Follow up action String False False

What action should be performed during follow up.

GDPR deleted Bool True False

Indicates the body of this engagement has been cleared because of a GDPR delete request.

Last modified at Datetime True False

The date any property on this engagement was modified.

Merged object IDs String True False

The list of object IDs that have been merged into this object. This value is automatically set by HubSpot and may not be modified.

Last modified by Decimal True False

The user who last updated the engagement.

MS Teams message ID String True False

The message ID for the created task.

Associated Companies Decimal True False

The number of companies associated with this task.

Associated Contacts Decimal True False

The number of contacts associated with this task.

Associated Deals Decimal True False

The number of deals associated with this task.

Associated Queue Objects Decimal True False

The number of objects associated with this task that support task queues.

Associated Tickets Decimal True False

The number of tickets associated with this task.

Record ID Decimal True False

The unique ID for this record. This value is automatically set by HubSpot and may not be modified.

Product name String False False

The name of the product associated with this engagement.

Queue String False False

The list of queues that contain this engagement.

Read Only Object Bool True False

Is the object read only.

Task repeat status String True False

Indicates whether the task is currently repeating .

Scheduled tasks String True False

Information about scheduled occurrences of the task.

Notes String False False

The content in the notes field on a task.

Completed at Datetime True False

The date that the task was completed.

Contact Time Zone String True False

The time zone of the associated contact.

For Object Type String False False

The object type for the task.

Task is all day Bool False False

Determines if the task is due all day or at a specific time.

Last contacted Datetime True False

The last time a call_ email_ or meeting was logged for the associated contact. This is set automatically by HubSpot based on user actions in the contact record.

Last engagement Datetime True False

The date of the last sales activity with the associated contact. This is set automatically by HubSpot based on user actions in the contact record.

Priority String False False

The priority of the task.

Task probability to complete Decimal True False

The probability the task will be completed.

Relative Task Reminders String False False

The dates _relative to the due date_ when reminders will be sent.

Reminder String False False

The dates when reminders will be sent.

Interval String True False

How often the task should repeat.

Send Default Reminder Bool False False

Whether or not a reminder should be sent when the task is due.

Sequence Enrollment Is Active Bool True False

Whether the sequence enrollment this task is a part of is currently active.

Sequence step enrollment Id String True False

The id of the sequence step that created the task.

Sequence step number Decimal True False

The order of this task in the sequence at time of enrollment.

Task Status String False False

The status of the task.

Task Title String False False

The subject text for the task.

Task template id Decimal True False

The id of template the task was created from.

Task Type String False False

The type of task.

Due date Datetime False False

The date that an engagement occurred.

Unique creation key String True False

Unique property used for idempotent creates.

Unique ID String False False

The unique ID of the engagement.

Updated by user ID Decimal True False

The user that last updated this object. This value is automatically set by HubSpot and may not be modified.

User IDs of all notification followers String True False

The user IDs of all users that have clicked follow within the object to opt_in to getting follow notifications.

User IDs of all notification unfollowers String True False

The user IDs of all object owners that have clicked unfollow within the object to opt_out of getting follow notifications.

User IDs of all owners String True False

The user IDs of all owners of this object.

Owner Assigned Date Datetime True False

The timestamp when an owner was assigned to this engagement.

Assigned to String False False

The user that the activity is assigned to in HubSpot. This can be any HubSpot user or Salesforce integration user_ and can be set manually or via Workflows.

HubSpot Team String True False

The team of the owner of an engagement.

All owner ids String True False

The value of all owner referencing properties for this object_ both default and custom.

All team ids String True False

The team ids corresponding to all owner referencing properties for this object_ both default and custom.

All accessible team ids String True False

The team ids_ including up the team hierarchy_ corresponding to all owner referencing properties for this object_ both default and custom.

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 24.0.9300