Use this endpoint to create an engagement (an email, call, meeting, task or note) on an object in HubSpot. Use case for this endpoint: This endpoint is useful for keeping your CRM records up-to-date on any interactions that take place outside of HubSpot. Activity reporting in the CRM also feeds off of this data.
You can associate engagements with objects to ensure they’re displayed correctly in the UI. Tasks created through HubSpot’s API will not trigger user notifications. For note-type engagements, the body of the note will be limited to 65536 characters.
Optional list of file IDs, corresponding to IDs you get for files from the CMS Files API.
An object representing the details of the engagement. Format varies by engagement type - see documentation for specific formats for EMAIL, CALL, MEETING, TASK, and NOTE types.