Troubleshooting starts by defining whether the issue is human, mapping, or connection error. If you are experiencing any other issues, check HubSpot's developer forums.
Troubleshooting problems with custom APIs with HubSpot can be a tricky process to nail down.
Firstly, you need to define whether the issue is human error, a mapping problem or a connection problem.
Human Error
If data is not pulling through into the fields correctly, it’s always worth double checking the values entered are legible. For example, putting letters into a number only field would cause an integration mapping error, the same goes for special characters.
Mapping Error
Once you have checked the data is valid, you will need to see if the problem is due to a mapping issue. Are the fields that need to be transferring data the same property type? For example, a single line text field in HubSpot may not map correctly to a number field in your other system. Always check the field types are aligned.
Connection Error
Next, if you are using an API key for your custom integration, you can head over to Settings > Integrations > API key > Call log to see if there are any connection issues (please note you will need to be a super admin to view this). If you are not using an API key, rather OAuth, it’s always worth checking your external logs for both HubSpot and your other system.
If you are experiencing any further issues:
The first point of call is to check the developers forum to see if your question has been answered before: https://community.hubspot.com/t5/HubSpot-Developers/ct-p/developers
This forum is a really great place to get advice with troubleshooting HubSpot integration issues. If you do not find any relevant information to answer your question, post one of your own tickets and the developers are usually quick to respond.