> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useparagon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Record Engagements



## OpenAPI

````yaml /actionkit/openapi.json POST /projects/{project_id}/tools/#HUBSPOT_UPDATE_RECORD_ENGAGEMENTS
openapi: 3.0.0
info:
  title: ActionKit Tools API
  version: 1.0.0
servers:
  - url: https://actionkit.useparagon.com
    description: US Cloud
security: []
paths:
  /projects/{project_id}/tools/#HUBSPOT_UPDATE_RECORD_ENGAGEMENTS:
    post:
      summary: Update Record Engagements
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Your Paragon Project ID. You can copy your Project ID from your
              dashboard URL or by clicking Copy Project ID under the Environment
              switcher.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tool:
                  type: string
                  default: HUBSPOT_UPDATE_RECORD_ENGAGEMENTS
                parameters:
                  type: object
                  properties:
                    engagementType:
                      type: string
                      description: Type
                      enum:
                        - NOTE
                        - EMAIL
                        - CALL
                        - MEETING
                        - TASK
                    noteBody:
                      type: string
                      description: |-
                        Note : The body of the note. 
                        This field appears only when 'engagementType' = 'NOTE')
                    fromEmail:
                      type: string
                      description: |-
                        From email : Email address of the sender. 
                        This field appears only when 'engagementType' = 'EMAIL')
                    fromFirstName:
                      type: string
                      description: |-
                        From first name : First name of the sender. 
                        This field appears only when 'engagementType' = 'EMAIL')
                    fromLastName:
                      type: string
                      description: |-
                        From last name : Last name of the sender. 
                        This field appears only when 'engagementType' = 'EMAIL')
                    toEmail:
                      type: string
                      description: |-
                        To email : Email address of the recipient. 
                        This field appears only when 'engagementType' = 'EMAIL')
                    ccEmail:
                      type: string
                      description: >-
                        CC emails : Array of email addresses for anyone cc’d on
                        the email. 

                        This field appears only when 'engagementType' = 'EMAIL')
                    bccEmail:
                      type: string
                      description: >-
                        BCC emails : Array of email addresses for anyone bcc’d
                        on the email. 

                        This field appears only when 'engagementType' = 'EMAIL')
                    emailSubject:
                      type: string
                      description: |-
                        Subject : Subject of the email. 
                        This field appears only when 'engagementType' = 'EMAIL')
                    emailText:
                      type: string
                      description: |-
                        Text : Body of the text-only email. 
                        This field appears only when 'engagementType' = 'EMAIL')
                    emailHtml:
                      type: string
                      description: |-
                        HTML : Body of the HTML email. 
                        This field appears only when 'engagementType' = 'EMAIL')
                    toNumber:
                      type: string
                      description: |-
                        To number : The phone number that was called. 
                        This field appears only when 'engagementType' = 'CALL')
                    fromNumber:
                      type: string
                      description: >-
                        From number : The phone number that was used as the from
                        number. 

                        This field appears only when 'engagementType' = 'CALL')
                    callNotes:
                      type: string
                      description: |-
                        Body : Details or notes of the call. 
                        This field appears only when 'engagementType' = 'CALL')
                    recordingUrl:
                      type: string
                      description: |-
                        Recording URL : The URL of the call recording. 
                        This field appears only when 'engagementType' = 'CALL')
                    meetingTitle:
                      type: string
                      description: >-
                        Title : Title or subject of the meeting. 

                        This field appears only when 'engagementType' =
                        'MEETING')
                    meetingNotes:
                      type: string
                      description: >-
                        Body : Details or notes of the meeting. 

                        This field appears only when 'engagementType' =
                        'MEETING')
                    startTime:
                      type: string
                      description: >-
                        Start time : Start time of the meeting (ISO or Unix
                        timestamp). (example: "2014-04-25T16:15:47-04:00") 

                        This field appears only when 'engagementType' =
                        'MEETING')
                    endTime:
                      type: string
                      description: >-
                        End time : End time of the meeting (ISO or Unix
                        timestamp). (example: "2014-04-25T16:15:47-04:00") 

                        This field appears only when 'engagementType' =
                        'MEETING')
                    taskSubject:
                      type: string
                      description: |-
                        Subject : Title or subject of the task. 
                        This field appears only when 'engagementType' = 'TASK')
                    taskNotes:
                      type: string
                      description: |-
                        Body : Details or notes of the task. 
                        This field appears only when 'engagementType' = 'TASK')
                    taskStatus:
                      type: string
                      description: |-
                        Status 
                        This field appears only when 'engagementType' = 'TASK')
                      enum:
                        - NOT_STARTED
                        - COMPLETED
                        - IN_PROGRESS
                        - WAITING
                        - DEFERRED
                    recordId:
                      type: string
                      description: Record ID
                    contactId:
                      type: string
                      description: >-
                        Contact ID : ID of the Contact the Engagement is related
                        to.
                    companyId:
                      type: string
                      description: >-
                        Company ID : ID of the Company the Engagement is related
                        to.
                    ownerId:
                      type: string
                      description: 'Owner ID : ID of the owner of the Engagement.'
                  required:
                    - engagementType
                    - recordId
                  x-integration: hubspot
              required:
                - tool
                - parameters
      responses:
        '200':
          description: Success
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your [Paragon User
        Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which
        you can generate using your project's signing keys.

````