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

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

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

## Request body

- CrmExtensionsCallingCompletedThirdPartyCallRequest
  - `callStartedTimestamp` string, date-time — The timestamp indicating when the call started, formatted as a date-time string.
  - `createEngagement` boolean, required — Indicates whether an engagement should be created for the call.
  - `durationSeconds` integer — The duration of the call in seconds.
  - `engagementProperties` object, required — Contains additional properties related to the engagement.
  - `externalCallId` string, required — The unique identifier for the call from an external system.
  - `finalCallStatus` 'BUSY' | 'CALLING_CRM_USER' | 'CANCELED' | 'COMPLETED' | 'CONNECTING' | 'FAILED' | 'HOLD' | 'IN_PROGRESS' | 'MISSED' | 'NO_ANSWER' | 'QUEUED' | 'RINGING' | 'UNKNOWN', required — The final status of the call, with accepted values including: BUSY, CALLING_CRM_USER, CANCELED, COMPLETED, CONNECTING, FAILED, HOLD, IN_PROGRESS, MISSED, NO_ANSWER, QUEUED, RINGING, UNKNOWN.
  - `fromNumber` CrmExtensionsCallingFormattedPhoneNumber, required
    - `e164Number` string, required — The phone number formatted in E.164 standard.
    - `extension` string — The extension number associated with the phone number.
    - `phoneNumberType` 'FIXED_LINE' | 'FIXED_LINE_OR_MOBILE' | 'MOBILE' | 'PAGER' | 'PERSONAL_NUMBER' | 'PREMIUM_RATE' | 'SHARED_COST' | 'TOLL_FREE' | 'UAN' | 'UNKNOWN' | 'VOICEMAIL' | 'VOIP', required — The type of phone number, with accepted values including FIXED_LINE, MOBILE, VOIP, and others.
  - `potentialRecipientUserIds` integer[], required
  - `toNumber` CrmExtensionsCallingFormattedPhoneNumber, required
    - `e164Number` string, required — The phone number formatted in E.164 standard.
    - `extension` string — The extension number associated with the phone number.
    - `phoneNumberType` 'FIXED_LINE' | 'FIXED_LINE_OR_MOBILE' | 'MOBILE' | 'PAGER' | 'PERSONAL_NUMBER' | 'PREMIUM_RATE' | 'SHARED_COST' | 'TOLL_FREE' | 'UAN' | 'UNKNOWN' | 'VOICEMAIL' | 'VOIP', required — The type of phone number, with accepted values including FIXED_LINE, MOBILE, VOIP, and others.
  - `userId` integer — The ID of the user associated with the call.

## Response `200`

successful operation

- CrmExtensionsCallingCompletedThirdPartyCallResponse
  - `callerIdMatches` union[], required
    - union
      - CrmExtensionsCallingContactCallerId
        - `callerIdType` 'CONTACT', required — Specifies the type of caller ID, with the default value being CONTACT.
        - `email` string — The email address of the contact.
        - `firstName` string — The first name of the contact.
        - `lastName` string — The last name of the contact.
        - `objectCoordinates` CrmExtensionsCallingObjectCoordinates, required
          - `objectId` integer, required — The unique identifier for the object.
          - `objectTypeId` string, required — The type identifier for the object.
          - `portalId` integer, required — The unique identifier for the portal.
      - CrmExtensionsCallingCompanyCallerId
        - `callerIdType` 'COMPANY', required — Specifies the type of caller ID, which is set to 'COMPANY' by default.
        - `name` string — The name associated with the company caller ID.
        - `objectCoordinates` CrmExtensionsCallingObjectCoordinates, required
          - `objectId` integer, required — The unique identifier for the object.
          - `objectTypeId` string, required — The type identifier for the object.
          - `portalId` integer, required — The unique identifier for the portal.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/versions/f9c7181056c5/schema)