How to log a call via API

Develop, Build & Integrate APIs & Integrations
1

Hi everyone!
Is it a way to log a call via api? Or add to custom timeline event action/properties to act like call log?
When I try to get list of event types, I only get my custom events. (Both with v1 and v3)

Thanks in advance for your reply.

2

Hi @Alex_Convolo,

Thanks for the post. If you’re trying to create a call engagment on a CRM record I’d suggest using our “Engagements API”. Specifically the “Create an Engagement” endpoint.

For instance the following POST request with payload:

https://api.hubapi.com/engagements/v1/engagements?hapikey={{INSERT_API_KEY_HERE}}

{
 "engagement": {
 "active": true,
 "ownerId": 22294961,
 "type": "CALL",
 "timestamp": 1596375786617,
 "activityType": "Pre-qualification"
 },
 "associations": {
 "contactIds": [
 389101
 ],
 "companyIds": [],
 "dealIds": [],
 "ownerIds": [],
 "ticketIds": []
 },
 "attachments": [
 {}
 ],
 "metadata": {
 "toNumber": "5618769964",
 "fromNumber": "(857) 829-5489",
 "status": "COMPLETED",
 "durationMilliseconds": 38000,
 "recordingUrl": "https://api.twilio.com/2010-04-01/Accounts/AC890b8e6fbe0d989bb9158e26046a8dde/Recordings/RE3079ac919116b2d22",
 "body": "This is a description of the call. It could be anything you like.",
 "disposition": "f240bbac-87c9-4f6e-bf70-924b57d47db7"
 }
}

Would result in the following engagement on the contact record in HubSpot:

Alternatively you could create your own custom timeline events using our "Timeline API". I’ve included a short video of how this works.

I hope this helps!

Jack

3

Hi @jackcoldrick

Thanks! I can able to create a activity with fromNumber, toNumber and Duration.
But i see that Contacted, Date and Time fields missing while adding the fromNumber, toNumber and Duration. Please suggest me if any field i missing from API request.