Saltar al contenido principal
POST
/
crm
/
extensions
/
calling
/
2026-03
/
inbound-call
Enviar detalles de una llamada entrante al CRM.
curl --request POST \
  --url https://api.hubapi.com/crm/extensions/calling/2026-03/inbound-call \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "createEngagement": true,
  "engagementProperties": {},
  "externalCallId": "<string>",
  "fromNumber": {
    "e164Number": "<string>",
    "extension": "<string>"
  },
  "potentialRecipientUserIds": [
    123
  ],
  "toNumber": {
    "e164Number": "<string>",
    "extension": "<string>"
  },
  "callStartedTimestamp": "2023-11-07T05:31:56Z",
  "durationSeconds": 123,
  "userId": 123
}
'
{
  "callerIdMatches": [
    {
      "callerIdType": "CONTACT",
      "objectCoordinates": {
        "objectId": 123,
        "objectTypeId": "<string>",
        "portalId": 123
      },
      "email": "<string>",
      "firstName": "<string>",
      "lastName": "<string>"
    }
  ]
}

Supported products

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Cuerpo

application/json
createEngagement
boolean
requerido

Indica si se debe crear una interacción para la llamada.

engagementProperties
object
requerido

Contiene propiedades adicionales relacionadas con la interacción.

externalCallId
string
requerido

El identificador único de la llamada desde un sistema externo.

finalCallStatus
enum<string>
requerido

El estado final de la llamada, con los siguientes valores aceptados: BUSY, CALLING_CRM_USER, CANCELED, COMPLETED, CONNECTING, FAILED, HOLD, IN_PROGRESS, MISSED, NO_ANSWER, QUEUED, RINGING, UNKNOWN.

Opciones disponibles:
BUSY,
CALLING_CRM_USER,
CANCELED,
COMPLETED,
CONNECTING,
FAILED,
HOLD,
IN_PROGRESS,
MISSED,
NO_ANSWER,
QUEUED,
RINGING,
UNKNOWN
fromNumber
object
requerido
potentialRecipientUserIds
integer<int32>[]
requerido
toNumber
object
requerido
callStartedTimestamp
string<date-time>

La marca de tiempo que indica cuándo comenzó la llamada, con formato de cadena de fecha y hora.

durationSeconds
integer<int32>

La duración de la llamada en segundos.

userId
integer<int32>

El ID del usuario asociado a la llamada.

Respuesta

successful operation

callerIdMatches
(CONTACT · object | COMPANY · object)[]
requerido
Última modificación el 5 de junio de 2026