HubSpot Engagement Calls API

openapi: 3.1.0
info:
  title: HubSpot CRM Engagement Calls API
  description: |
    The HubSpot CRM Engagement Calls API enables you to manage call engagements within your HubSpot CRM.

    Use this API to:
    - Create, read, update, and delete call records
    - Perform batch operations on multiple calls
    - Search for calls using filters and queries
    - Associate calls with contacts, companies, deals, and other CRM objects
    - Manage call properties and track call history
    - Handle GDPR-compliant data purging

    Call engagements represent phone calls logged in your CRM and can include details like duration, outcome, notes, and recordings.
  version: 3.0.0
  contact:
    name: HubSpot Developer Support
    url: https://developers.hubspot.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://api.hubapi.com
  description: HubSpot Production API Server
tags:
- name: Basic Operations
  description: Create, read, update, and delete individual call records
- name: Batch Operations
  description: Perform bulk operations on multiple call records
- name: GDPR Compliance
  description: GDPR-compliant data management operations
- name: Search
  description: Search and filter call records
paths:
  /crm/v3/objects/calls:
    get:
      tags:
      - Basic Operations
      summary: Hubspot List All Calls
      description: |
        Returns a paginated list of all call engagements in the CRM.
        Use query parameters to filter by properties, limit results, and paginate through records.
      operationId: listCalls
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "ListCallsSuccessResponse"
      parameters:
      - $ref: '#/components/parameters/LimitParam'
        example: example-value
      - $ref: '#/components/parameters/AfterParam'
        example: example-value
      - $ref: '#/components/parameters/PropertiesParam'
        example: example-value
      - $ref: '#/components/parameters/PropertiesWithHistoryParam'
        example: example-value
      - $ref: '#/components/parameters/AssociationsParam'
        example: example-value
      - $ref: '#/components/parameters/ArchivedParam'
        example: example-value
      responses:
        '200':
          description: Successfully retrieved the list of calls
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallCollectionResponse'
              examples:
                ListCallsSuccessResponse:
                  $ref: '#/components/examples/ListCallsSuccessResponse'
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.read
      - PrivateApp:
        - crm.objects.contacts.read
    post:
      tags:
      - Basic Operations
      summary: Hubspot Create a Call
      description: |
        Creates a new call engagement in the CRM.
        You can specify call properties and optionally associate the call with other CRM objects.
      operationId: createCall
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "CreateCallSuccessResponse"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CallCreateRequest'
            examples:
              CreateCallRequest:
                $ref: '#/components/examples/CreateCallRequest'
      responses:
        '201':
          description: Successfully created the call
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Call'
              examples:
                CreateCallSuccessResponse:
                  $ref: '#/components/examples/CreateCallSuccessResponse'
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.write
      - PrivateApp:
        - crm.objects.contacts.write
  /crm/v3/objects/calls/{callId}:
    get:
      tags:
      - Basic Operations
      summary: Hubspot Get a Call by Id
      description: |
        Retrieves a single call engagement by its unique identifier.
        Optionally include specific properties, property history, and associations.
      operationId: getCallById
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "GetCallSuccessResponse"
      parameters:
      - $ref: '#/components/parameters/CallIdParam'
        example: example-value
      - $ref: '#/components/parameters/PropertiesParam'
        example: example-value
      - $ref: '#/components/parameters/PropertiesWithHistoryParam'
        example: example-value
      - $ref: '#/components/parameters/AssociationsParam'
        example: example-value
      - $ref: '#/components/parameters/ArchivedParam'
        example: example-value
      responses:
        '200':
          description: Successfully retrieved the call
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Call'
              examples:
                GetCallSuccessResponse:
                  $ref: '#/components/examples/GetCallSuccessResponse'
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.read
      - PrivateApp:
        - crm.objects.contacts.read
    patch:
      tags:
      - Basic Operations
      summary: Hubspot Update a Call
      description: |
        Updates an existing call engagement with new property values.
        Only the properties specified in the request body will be updated.
      operationId: updateCall
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "UpdateCallSuccessResponse"
      parameters:
      - $ref: '#/components/parameters/CallIdParam'
        example: example-value
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CallUpdateRequest'
            examples:
              UpdateCallRequest:
                $ref: '#/components/examples/UpdateCallRequest'
      responses:
        '200':
          description: Successfully updated the call
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Call'
              examples:
                UpdateCallSuccessResponse:
                  $ref: '#/components/examples/UpdateCallSuccessResponse'
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.write
      - PrivateApp:
        - crm.objects.contacts.write
    delete:
      tags:
      - Basic Operations
      summary: Hubspot Archive a Call
      description: |
        Archives (soft deletes) a call engagement by moving it to the recycling bin.
        Archived calls can be restored within 90 days.
      operationId: archiveCall
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "ArchiveCallSuccessResponse"
      parameters:
      - $ref: '#/components/parameters/CallIdParam'
        example: example-value
      responses:
        '204':
          description: Successfully archived the call (no content returned)
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.write
      - PrivateApp:
        - crm.objects.contacts.write
  /crm/v3/objects/calls/batch/create:
    post:
      tags:
      - Batch Operations
      summary: Hubspot Create a Batch of Calls
      description: |
        Creates multiple call engagements in a single request.
        Each call can have its own properties and associations.
        Maximum of 100 calls per batch request.
      operationId: batchCreateCalls
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "BatchCreateCallsSuccessResponse"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchCreateCallsRequest'
            examples:
              BatchCreateCallsRequest:
                $ref: '#/components/examples/BatchCreateCallsRequest'
      responses:
        '201':
          description: Successfully created the batch of calls
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchCallsResponse'
              examples:
                BatchCreateCallsSuccessResponse:
                  $ref: '#/components/examples/BatchCreateCallsSuccessResponse'
        '207':
          description: Multi-status response (some operations succeeded, some failed)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchCallsResponse'
              examples:
                Batchcreatecalls207Example:
                  summary: Default batchCreateCalls 207 response
                  x-microcks-default: true
                  value:
                    status: "COMPLETE"
                    results: &id001
                    - id: "512"
                      properties: &id004
                        hs_call_title: "Discovery Call"
                        hs_call_body: "Discussed product requirements"
                        hs_call_duration: "1800000"
                        hs_call_direction: "OUTBOUND"
                        hs_call_disposition: "connected"
                        hs_call_status: "COMPLETED"
                        hs_timestamp: "2024-01-15T10:30:00.000Z"
                      propertiesWithHistory: &id005
                        key: value
                      createdAt: "2024-01-15T10:30:00.000Z"
                      updatedAt: "2024-01-15T11:00:00.000Z"
                      archived: false
                      archivedAt: '2025-03-15T14:30:00Z'
                    requestedAt: '2025-03-15T14:30:00Z'
                    startedAt: "2024-01-15T10:30:00.000Z"
                    completedAt: "2024-01-15T10:30:05.000Z"
                    errors: &id002
                    - status: "error"
                      category: "VALIDATION_ERROR"
                      message: "Property value is invalid"
                      context:
                        key: value
                      errors:
                      - {}
                    links: &id003
                      key: value
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.write
      - PrivateApp:
        - crm.objects.contacts.write
  /crm/v3/objects/calls/batch/read:
    post:
      tags:
      - Batch Operations
      summary: Hubspot Read a Batch of Calls
      description: |
        Retrieves multiple call engagements by their IDs or a unique property value.
        Maximum of 100 calls per batch request.
      operationId: batchReadCalls
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "BatchReadCallsSuccessResponse"
      parameters:
      - $ref: '#/components/parameters/ArchivedParam'
        example: example-value
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchReadCallsRequest'
            examples:
              BatchReadCallsRequest:
                $ref: '#/components/examples/BatchReadCallsRequest'
      responses:
        '200':
          description: Successfully retrieved the batch of calls
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchCallsResponse'
              examples:
                BatchReadCallsSuccessResponse:
                  $ref: '#/components/examples/BatchReadCallsSuccessResponse'
        '207':
          description: Multi-status response (some operations succeeded, some failed)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchCallsResponse'
              examples:
                Batchreadcalls207Example:
                  summary: Default batchReadCalls 207 response
                  x-microcks-default: true
                  value:
                    status: "COMPLETE"
                    results: *id001
                    requestedAt: '2025-03-15T14:30:00Z'
                    startedAt: "2024-01-15T10:30:00.000Z"
                    completedAt: "2024-01-15T10:30:05.000Z"
                    errors: *id002
                    links: *id003
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.read
      - PrivateApp:
        - crm.objects.contacts.read
  /crm/v3/objects/calls/batch/update:
    post:
      tags:
      - Batch Operations
      summary: Hubspot Update a Batch of Calls
      description: |
        Updates multiple call engagements in a single request.
        Each call update must include the call ID and the properties to update.
        Maximum of 100 calls per batch request.
      operationId: batchUpdateCalls
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "BatchUpdateCallsSuccessResponse"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchUpdateCallsRequest'
            examples:
              BatchUpdateCallsRequest:
                $ref: '#/components/examples/BatchUpdateCallsRequest'
      responses:
        '200':
          description: Successfully updated the batch of calls
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchCallsResponse'
              examples:
                BatchUpdateCallsSuccessResponse:
                  $ref: '#/components/examples/BatchUpdateCallsSuccessResponse'
        '207':
          description: Multi-status response (some operations succeeded, some failed)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchCallsResponse'
              examples:
                Batchupdatecalls207Example:
                  summary: Default batchUpdateCalls 207 response
                  x-microcks-default: true
                  value:
                    status: "COMPLETE"
                    results: *id001
                    requestedAt: '2025-03-15T14:30:00Z'
                    startedAt: "2024-01-15T10:30:00.000Z"
                    completedAt: "2024-01-15T10:30:05.000Z"
                    errors: *id002
                    links: *id003
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.write
      - PrivateApp:
        - crm.objects.contacts.write
  /crm/v3/objects/calls/batch/archive:
    post:
      tags:
      - Batch Operations
      summary: Hubspot Archive a Batch of Calls
      description: |
        Archives (soft deletes) multiple call engagements in a single request.
        Maximum of 100 calls per batch request.
      operationId: batchArchiveCalls
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "BatchArchiveCallsSuccessResponse"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchArchiveCallsRequest'
            examples:
              BatchArchiveCallsRequest:
                $ref: '#/components/examples/BatchArchiveCallsRequest'
      responses:
        '204':
          description: Successfully archived the batch of calls (no content returned)
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.write
      - PrivateApp:
        - crm.objects.contacts.write
  /crm/v3/objects/calls/search:
    post:
      tags:
      - Search
      summary: Hubspot Search Calls
      description: |
        Searches for call engagements using filters, property values, and full-text search.
        Supports complex filter groups with AND/OR logic.
      operationId: searchCalls
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "SearchCallsSuccessResponse"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CallSearchRequest'
            examples:
              SearchCallsRequest:
                $ref: '#/components/examples/SearchCallsRequest'
      responses:
        '200':
          description: Successfully searched calls
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallSearchResponse'
              examples:
                SearchCallsSuccessResponse:
                  $ref: '#/components/examples/SearchCallsSuccessResponse'
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.read
      - PrivateApp:
        - crm.objects.contacts.read
  /crm/v3/objects/calls/gdpr-delete:
    post:
      tags:
      - GDPR Compliance
      summary: Hubspot Permanently Delete a Call for Gdpr Compliance
      description: |
        Permanently deletes a call engagement for GDPR compliance.
        This action cannot be undone. Use this endpoint when you need to comply with a data subject's right to erasure request.
      operationId: gdprDeleteCall
      x-microcks-operation:
        dispatcher: SCRIPT
        dispatcherRules: |
          return "GdprDeleteCallSuccessResponse"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GdprDeleteRequest'
            examples:
              GdprDeleteRequest:
                $ref: '#/components/examples/GdprDeleteRequest'
      responses:
        '204':
          description: Successfully deleted the call (no content returned)
        default:
          description: An error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ErrorResponse:
                  $ref: '#/components/examples/ErrorResponse'
      security:
      - OAuth2:
        - crm.objects.contacts.write
      - PrivateApp:
        - crm.objects.contacts.write
components:
  schemas:
    Call:
      type: object
      description: Represents a call engagement in the CRM
      required:
      - id
      - properties
      - createdAt
      - updatedAt
      - archived
      properties:
        id:
          type: string
          description: The unique identifier for the call
          example: "512"
        properties:
          type: object
          description: The call properties
          additionalProperties:
            type: string
          example: *id004
        propertiesWithHistory:
          type: object
          description: Properties with their change history
          additionalProperties:
            type: array
            items:
              $ref: '#/components/schemas/PropertyHistory'
          example: *id005
        createdAt:
          type: string
          format: date-time
          description: When the call was created
          example: "2024-01-15T10:30:00.000Z"
        updatedAt:
          type: string
          format: date-time
          description: When the call was last updated
          example: "2024-01-15T11:00:00.000Z"
        archived:
          type: boolean
          description: Whether the call is archived
          example: false
        archivedAt:
          type: string
          format: date-time
          description: When the call was archived (if archived)
          example: '2025-03-15T14:30:00Z'
    PropertyHistory:
      type: object
      description: Historical value of a property
      properties:
        value:
          type: string
          description: The historical value
          example: "Discovery Call"
        timestamp:
          type: string
          format: date-time
          description: When the value was set
          example: "2024-01-15T10:30:00.000Z"
        sourceType:
          type: string
          description: The source type that set this value
          example: "CRM_UI"
        sourceId:
          type: string
          description: The source identifier
          example: "userId:12345"
        sourceLabel:
          type: string
          description: Human-readable source label
          example: "John Doe"
        updatedByUserId:
          type: integer
          description: The user ID who made the change
          example: 12345
    CallCollectionResponse:
      type: object
      description: A paginated collection of calls
      required:
      - results
      properties:
        results:
          type: array
          description: The list of calls
          items:
            $ref: '#/components/schemas/Call'
          example:
          - id: "512"
            properties: *id004
            propertiesWithHistory: *id005
            createdAt: "2024-01-15T10:30:00.000Z"
            updatedAt: "2024-01-15T11:00:00.000Z"
            archived: false
            archivedAt: '2025-03-15T14:30:00Z'
        paging:
          $ref: '#/components/schemas/Paging'
    CallSearchResponse:
      type: object
      description: Search results for calls
      required:
      - total
      - results
      properties:
        total:
          type: integer
          description: Total number of matching calls
          example: 25
        results:
          type: array
          description: The matching calls
          items:
            $ref: '#/components/schemas/Call'
          example:
          - id: "512"
            properties: *id004
            propertiesWithHistory: *id005
            createdAt: "2024-01-15T10:30:00.000Z"
            updatedAt: "2024-01-15T11:00:00.000Z"
            archived: false
            archivedAt: '2025-03-15T14:30:00Z'
        paging:
          $ref: '#/components/schemas/Paging'
    BatchCallsResponse:
      type: object
      description: Response for batch call operations
      required:
      - status
      - results
      - startedAt
      - completedAt
      properties:
        status:
          type: string
          enum:
          - PENDING
          - PROCESSING
          - CANCELED
          - COMPLETE
          description: The status of the batch operation
          example: "COMPLETE"
        results:
          type: array
          description: The results of the batch operation
          items:
            $ref: '#/components/schemas/Call'
          example: *id001
        requestedAt:
          type: string
          format: date-time
          description: When the batch was requested
          example: '2025-03-15T14:30:00Z'
        startedAt:
          type: string
          format: date-time
          description: When the batch processing started
          example: "2024-01-15T10:30:00.000Z"
        completedAt:
          type: string
          format: date-time
          description: When the batch processing completed
          example: "2024-01-15T10:30:05.000Z"
        errors:
          type: array
          description: Any errors that occurred during batch processing
          items:
            $ref: '#/components/schemas/BatchError'
          example: *id002
        links:
          type: object
          additionalProperties:
            type: string
          example: *id003
    BatchError:
      type: object
      description: Error information for a batch operation item
      properties:
        status:
          type: string
          description: The error status
          example: "error"
        category:
          type: string
          description: The error category
          example: "VALIDATION_ERROR"
        message:
          type: string
          description: The error message
          example: "Property value is invalid"
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          example:
            key: value
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ErrorDetail'
          example:
          - message: This is an example description.
            code: example-value
            in: example-value
            subCategory: standard
            context:
              key: value
    CallCreateRequest:
      type: object
      description: Request body for creating a call
      required:
      - properties
      properties:
        properties:
          type: object
          description: The call properties to set
          additionalProperties:
            type: string
          example: &id006
            hs_call_title: "Discovery Call"
            hs_call_body: "Discussed product requirements"
            hs_call_duration: "1800000"
            hs_call_direction: "OUTBOUND"
            hs_timestamp: "2024-01-15T10:30:00.000Z"
        associations:
          type: array
          description: Associations to create with other objects
          items:
            $ref: '#/components/schemas/AssociationInput'
          example: &id007
          - to:
              id: {}
            types:
            - {}
    CallUpdateRequest:
      type: object
      description: Request body for updating a call
      required:
      - properties
      properties:
        properties:
          type: object
          description: The call properties to update
          additionalProperties:
            type: string
          example:
            hs_call_title: "Updated Discovery Call"
            hs_call_disposition: "connected"
    BatchCreateCallsRequest:
      type: object
      description: Request body for batch creating calls
      required:
      - inputs
      properties:
        inputs:
          type: array
          description: Array of calls to create
          items:
            $ref: '#/components/schemas/CallCreateRequest'
          maxItems: 100
          example:
          - properties: *id006
            associations: *id007
    BatchReadCallsRequest:
      type: object
      description: Request body for batch reading calls
      required:
      - inputs
      properties:
        inputs:
          type: array
          description: Array of call identifiers
          items:
            $ref: '#/components/schemas/BatchReadInput'
          maxItems: 100
          example:
          - id: "512"
        properties:
          type: array
          description: Properties to return
          items:
            type: string
          example:
          - example-value
        propertiesWithHistory:
          type: array
          description: Properties to return with history
          items:
            type: string
          example:
          - example-value
        idProperty:
          type: string
          description: The property to use as the identifier
          example: '500123'
    BatchReadInput:
      type: object
      description: Input for reading a single item in a batch
      required:
      - id
      properties:
        id:
          type: string
          description: The call identifier
          example: "512"
    BatchUpdateCallsRequest:
      type: object
      description: Request body for batch updating calls
      required:
      - inputs
      properties:
        inputs:
          type: array
          description: Array of call updates
          items:
            $ref: '#/components/schemas/BatchUpdateInput'
          maxItems: 100
          example:
          - id: "512"
            properties:
              key: value
    BatchUpdateInput:
      type: object
      description: Input for updating a single item in a batch
      required:
      - id
      - properties
      properties:
        id:
          type: string
          description: The call identifier
          example: "512"
        properties:
          type: object
          description: The properties to update
          additionalProperties:
            type: string
          example:
            key: value
    BatchArchiveCallsRequest:
      type: object
      description: Request body for batch archiving calls
      required:
      - inputs
      properties:
        inputs:
          type: array
          description: Array of call identifiers to archive
          items:
            $ref: '#/components/schemas/BatchReadInput'
          maxItems: 100
          example:
          - id: "512"
    CallSearchRequest:
      type: object
      description: Request body for searching calls
      properties:
        filterGroups:
          type: array
          description: Filter groups for the search (OR logic between groups)
          items:
            $ref: '#/components/schemas/FilterGroup'
          example:
          - filters:
            - {}
        sorts:
          type: array
          description: Sort order for results
          items:
            $ref: '#/components/schemas/SortOption'
          example:
          - propertyName: "hs_timestamp"
            direction: DESCENDING
        query:
          type: string
          description: Full-text search query
          example: "discovery"
        properties:
          type: array
          description: Properties to return
          items:
            type: string
          example:
          - example-value
        limit:
          type: integer
          description: Maximum results to return
          default: 10
          maximum: 100
          example: 10
        after:
          type: string
          description: Pagination cursor
          example: example-value
    FilterGroup:
      type: object
      description: A group of filters (AND logic within group)
      properties:
        filters:
          type: array
          d

# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/openapi/hubspot-engagement-calls-api-openapi.yml