Hi, @taropaa.
Happy to clarify! I’ve addressed your questions below:
1. HubSpot will not automatically associate CALL engagements with contacts by the toNumber value in the metadata object. As when creating other types of engagements, you must include the associations object and list the desired contact vids in the contactIds array.
That said, you can pass phone number values in any format to the toNumber and fromNumber fields. HubSpot will display whatever you send on the contact timeline.
2. The externalId and externalAccountId fields are actually defined on the Engagements Overview page:
externalIdis a string for calls made in HubSpot. It is not used for engagements created through the API.- Similarly,
externalAccountIdis also used for calls made in HubSpot and has no bearing on API-generated calls.