---
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

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/extensions/calling/2026-03/inbound-call`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `hapikey`
  - none

## 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.

## Changes

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-04-08** `b0d8bc008db9`: 3 info
  - api operation id `post-/crm/extensions/calling/2026-03/inbound-call_/crm/v3/extensions/calling/inbound-call` removed and replaced with `post-/crm/extensions/calling/2026-03/inbound-call`
  - the security scope `crm.objects.contacts.highly_sensitive.write` was added to the endpoint's security scheme `private_apps`
  - the security scope `crm.schemas.contacts.write` was removed from the endpoint's security scheme `private_apps`
- **2026-04-03** `3578967e48df`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write` was added to the endpoint's security scheme `private_apps`
  - the security scope `crm.schemas.contacts.write` was removed from the endpoint's security scheme `private_apps`
- **2026-04-01** `e0403341222c`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write` was added to the endpoint's security scheme `private_apps`
  - the security scope `crm.schemas.contacts.write` was removed from the endpoint's security scheme `private_apps`
- **2026-03-31** `f33be5a82610`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write` was added to the endpoint's security scheme `private_apps`
  - the security scope `crm.schemas.contacts.write` was removed from the endpoint's security scheme `private_apps`
- …earlier changes not shown

[Operation history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/crm/extensions/calling/2026-03/inbound-call/post.md)

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) - [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/hubspot-api-specification/revisions/f9c7181056c5?raw)