Action - Create or Update a Contact in NetSuite

Reference manual for Create or Update a Contact in NetSuite action

Action: Create or Update a Contact in NetSuite

Overview

This action creates a new contact or updates an existing one in NetSuite.

Whether a record is created or updated depends on several conditions.

To prevent duplicate contacts, the action implements a three-level duplicate check:

  1. Existing Contact ID
    1. If the Contact ID field is populated with an existing NetSuite contact ID, the action will update that record instead of creating a new one.

  1. External ID Matching
    1. If the Contact ID field is empty but the External ID field is provided and a record with that External ID already exists, the action will also update the existing contact rather than create a duplicate.

  1. Previously Saved Record Reference
    1. After a contact has been successfully created or updated once, the action stores the resulting record ID. On subsequent operations, it will reuse this saved ID to continue updating the same record instead of creating a new one.

Example Use Case

As an example, you can use this action to synchronise a HubSpot contact with a NetSuite contact.

In HubSpot, there is often a custom field that stores the corresponding NetSuite Contact ID.

During synchronisation, you might need to update the First Name and Last Name fields in NetSuite.

Here’s how you can set it up:

  1. In your data table, you have the following columns:
      • HubSpot Contact ID
      • NetSuite ID
      • First Name
      • Last Name
  1. Add a new Action by clicking the + button (as you would when adding a new column).
    1. Choose Action β†’ Create or Update a Contact in NetSuite.

  1. In the action configuration:
      • In the Id field, select the column that contains the NetSuite ID.
      • Click Add field and choose External ID β€” map it to your HubSpot Contact ID column.
      Notion image
      • Then add the fields you want to update, such as First Name and Last Name, mapping them to the respective columns.
        • Notion image
  1. Once all fields are mapped correctly, click Add Action to save and activate it.

Requirements

To use this action, make sure that your NetSuite integration is properly configured.

The action relies on valid API credentials and access permissions to create or update contact records in your NetSuite account.

Summary

This action provides a reliable way to keep your contact data synchronized between systems like HubSpot and NetSuite while ensuring that no duplicate records are created.

With proper setup, it helps maintain clean and up-to-date contact information across your integrations.

Did this answer your question?
😞
😐
🀩

Last updated on November 4, 2025