How Can I Get Call Outcome Data Using the Engagement API?

Question

When a HubSpot owner finishes a call to a client, it's possible to register Call Outcome.

The possible Call Outcome statuses are:

• No answer
• Busy
• Wrong number
• Left live message
• Left voicemail
• Connected

How can I get this information using the Engagement API?

Answer

HubSpot doesn't offer a direct way to get this information.

However there's a workaround suggested in the HubSpot Help Center. When you pull call engagements using the get all engagements endpoint, you’ll notice that call-type engagements contain a field in their metadata called disposition. This field correlates to the Call Outcome status that appears on the call in HubSpot.

The following table maps disposition values with Call Outcome values. You can use any decrypting method to get the Call Outcome status from the disposition values in the table.