Resolving "Invalid entitystatus reference key" Error When Syncing Companies to NetSuite

If you're encountering an "Invalid entitystatus reference key" error when syncing companies from HubSpot to NetSuite, this typically occurs when the integration attempts to create a Customer record with a Lead status, which NetSuite doesn't allow.

Understanding the Error

The error message "Invalid entitystatus reference key [number]" appears when:

• A company record doesn't exist in NetSuite yet

• The integration tries to create a Customer record with a Lead status

• NetSuite rejects this combination as invalid

How to Fix This Issue

Contact support at [email protected] as we will have to configure changes to mappings.

What Happens After the Fix

When the integration processes these records again:

• The system will create the record in NetSuite as a "Lead" instead of trying to force a Customer status

• The correct status will be applied in NetSuite based on your configured mapping

• Future syncs should work normally

If you continue to experience issues after following these steps, contact support for assistance in identifying and resolving the affected records.