---
title: "POST /crm/extensions/calling/2026-09/inbound-call"
method: POST
path: "/crm/extensions/calling/2026-09/inbound-call"
tags: ["Advanced"]
---

# POST /crm/extensions/calling/2026-09/inbound-call

`POST /crm/extensions/calling/2026-09/inbound-call`

## Request body

- CompletedThirdPartyCallRequest
  - `callStartedTimestamp` string, date-time
  - `createEngagement` boolean, required
  - `durationSeconds` integer
  - `engagementProperties` object, required
  - `externalCallId` string, required
  - `finalCallStatus` 'BUSY' | 'CALLING_CRM_USER' | 'CANCELED' | 'COMPLETED' | 'CONNECTING' | 'FAILED' | 'HOLD' | 'IN_PROGRESS' | 'MISSED' | 'NO_ANSWER' | 'QUEUED' | 'RINGING' | 'UNKNOWN', required
  - `fromNumber` FormattedPhoneNumber, required
    - `e164Number` string, required
    - `extension` string
    - `phoneNumberType` 'FIXED_LINE' | 'FIXED_LINE_OR_MOBILE' | 'MOBILE' | 'PAGER' | 'PERSONAL_NUMBER' | 'PREMIUM_RATE' | 'SHARED_COST' | 'TOLL_FREE' | 'UAN' | 'UNKNOWN' | 'VOICEMAIL' | 'VOIP', required
  - `potentialRecipientUserIds` integer[], required
  - `toNumber` FormattedPhoneNumber, required
    - `e164Number` string, required
    - `extension` string
    - `phoneNumberType` 'FIXED_LINE' | 'FIXED_LINE_OR_MOBILE' | 'MOBILE' | 'PAGER' | 'PERSONAL_NUMBER' | 'PREMIUM_RATE' | 'SHARED_COST' | 'TOLL_FREE' | 'UAN' | 'UNKNOWN' | 'VOICEMAIL' | 'VOIP', required
  - `userId` integer

## Response `200`

successful operation

- CompletedThirdPartyCallResponse
  - `callerIdMatches` union[], required
    - union
      - ContactCallerId
        - `callerIdType` 'CONTACT', required
        - `email` string
        - `firstName` string
        - `lastName` string
        - `objectCoordinates` ObjectCoordinates, required
          - `objectId` integer, required
          - `objectTypeId` string, required
          - `portalId` integer, required
      - CompanyCallerId
        - `callerIdType` 'COMPANY', required
        - `name` string
        - `objectCoordinates` ObjectCoordinates, required
          - `objectId` integer, required
          - `objectTypeId` string, required
          - `portalId` integer, required

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/crm-calling-extensions.md) · [All operations](https://skmtc.net/hubspot/apis/crm-calling-extensions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/crm-calling-extensions/revisions/43b228cfd340/schema)