Skip to main content
Act-On Software

NetSuite Integration Guide


Act-On’s integration with NetSuite CRM allows you to share contact information between your NetSuite CRM database and Act-On.

The Act-On / NetSuite Plugin extends Act-On into the NetSuite CRM – giving CRM users access to a contact or lead’s activity history, extending the ability to use Act-On’s trackable email to message a lead or contact directly within the CRM, and adds Act-On’s Hot Prospect technology right into your NetSuite CRM Dashboard.

In order to integrate Act-On with your Netsuite instance, you'll need to authenticate to Act-On using credentials for that Netsuite account. To ensure that the account you are authenticating with has the proper permissions and generate the credentials required to connect to Act-On, you'll first need to log into Netsuite and follow the instructions specified in this document (summarized in Generating Admin Authentication Credentials in Netsuite and Generating Non-Admin Authentication Credentials in Netsuite sections below).

Generating Admin Authentication Credentials in Netsuite

  1. Log into your Netsuite account using an admin role
  2. Navigate to Setup > Company > Enable Features > SuiteCloud
  3. On the SuiteCloud tab, enable the following features in the SuiteScript, SuiteTalk and Manage Authentication sections:
    1. SuiteScript: Client SuiteScript, Server SuiteScript
    2. SuiteTalk: Web Services
    3. Manage Authentication: SuiteSignOn, Token-Based AuthenticationScreen Shot 2018-12-13 at 2.58.53 PM.png
  4. Click Save .
  5. Next, navigate to Setup > Integrations > Manage Integrations
  6. Select New to create an application for your Act-On integration
  7. Give your integration a descriptive name (e.g. ActOnTBA), select User Credentials and Token Based Authentication in the Authentication section and click Save
  8. Once the integration has been saved successfully a Consumer Key and Consumer Secret will be displayed

Generating Admin Credentials in Netsuite

  1. From an admin account, navigate to Home > Settings > Manage Access Tokens
  2. Click New My Access Token
  3. Select the application you just created (e.g. ActOnTBA) from the Application Name dropdown, the Token Name field will autopopulate

Screen Shot 2018-12-13 at 3.36.57 PM.png

  1. Click Save
  2. The Token ID and Token Secret will be displayed and can be used, along with the Consumer Key and Consumer Secret from step 8, to authenticate to Act-On following the steps described in the Connecting to Netsuite from Act-On section below

Note: Keep the page with your Consumer Key and Consumer Secret open until you are ready to enter them into Act-On. If you navigate away from the screen, don't worry, you'll just need to generate those credentials again following the instructions from Netsuite.

Generating Non-Admin Credentials in Netsuite

We recommend connecting to Netsuite using an admin role. If you choose to do so using an integration role, please follow the steps below to ensure that the user has the proper authentication permissions.

  1. Log in to a Netsuite admin account and navigate to Setup > User Roles > Manage Roles
  2. Select the role you intend to use for your integration and click Edit button in their record
  3. Scroll down to the Access section and select Global Permissions
  4. Select User Access Tokens  from the dropdown menu and click Add
    Screen Shot 2018-12-13 at 4.09.22 PM.png
  5. Click Save
  6. Log in to the account you've just enabled with User Access Token permissions
  7. Navigate to Home > Settings > Manage Access Tokens
  8. Click New My Access Token
  9. The Token ID and Token Secret will be displayed and can be used, along with the Consumer Key and Consumer Secret generated from an admin account to authenticate to Netsuite from Act-On following the steps below

Connecting to Netsuite from Act-On

  1. Click the Settings gear icon, choose Connectors
  2. Under CRM, choose NetSuite
  3. Enter the specified credentials in the login modal (see instructions above for generating credentials)

Netsuite TBA Login.png

  1. The connection to NetSuite is now established.

Import contacts

To start marketing to your NetSuite contacts, you will need to first import them into Act-On. To do this, go to your marketing lists and select the Import button that has the NetSuite logo on it:

You will have four different options to import

  • Affiliated with Customers -this is a contact whose affiliated company stage is set to Customer.
  • Affiliated with Prospects – this is a contact whose affiliated company stage is set to Prospect.
  • Affiliated with Leads – this is a contact whose affiliated company stage is set to Lead.
  • Unaffiliated – any contact who is not affiliated with a company

Selecting an option will put in a default name for the new list. The name can be changed, and must be unique within Act-On. 

After choosing the list you would like to import, click Next. Act-On will retrieve the fields available for import.

Choose the fields that you would like to import and click Finish. The imported data can be used to personalize messages, or to segment lists.

The field selection can be changed any time after import.

Special fields:

  • Email – Act-On uses email as the key to track behavior, so this field is very important to include.
  • Score – this is a new custom field that was created in NetSuite via the Act-On Connector.  It is designed to contain the Act-On Lead Score.  If you would like to see the lead score in NetSuite, then you must include this field in your selection set.

This process can take just a few minutes for a few contacts, or many tens of minutes for thousands. When it completes, the dots will change to a numeric record count. You can repeat these steps to import other lists (Customers, Prospects, Leads, and/or Unaffiliated).

The initial import is a one-time event. If you wish to keep the list synchronized with NetSuite CRM, you can create and schedule an automated sync.

To schedule an automated sync:

  • Hover the cursor over the list you wish to enable
  • Click Import and Export and choose NetSuite CRM Sync Setup

A dialog box will open. Here, you can set schedules to automatically push or pull data between NetSuite CRM and Act-On. Typically, Act-On customers will push the Act-On lead score to NetSuite CRM, and pull all of the other values.

To enable this:

  • Check the Push to NetSuite CRM box and the Update box under Push.
  • Click on the Select Push-Update Fields link.
  • The next dialog box that opens offers fields to select.

To push lead scores to NetSuite:

  • Choose Score
  • Save.

After saving, click on Pull from NetSuite CRM. In general:

  • Check the Add box if you would like new contacts to be added into Act-On. Most customers do select this.
  • Check the Update box if you want to update specific fields in your Act-On list with new or updated data points in your NetSuite CRM.
  • Check Remove to remove contacts from Act-On that were removed in NetSuite CRM.

To continue on with our instructions for pushing a lead score from your Act-On list to your NetSuite CRM:

  • Check Update in the Pull From dialog box.
  • Check on the Select Push-Update Fields.
  • Check Act-On Score.
  • After saving, click the Schedule button.

You can setup when you would like the sync to occur. It can be set as often as every four hours. “Daily” is the most common selection. Click the save button to finish the sync setup. Repeat these steps for the other lists you would like to keep in sync.

After doing an import, you can add additional fields to a current list. To do this

  • Go to the NetSuite CRM Sync Setup under the More menu and click the Add List Columns button.
  • A dialog box will open, allowing you to choose the new fields to add.

Push lead scores to NetSuite

The Act-On Score column must be updated before doing the sync with the CRM. This can be done automatically by use of a “List Maintenance Program”. To set this up:

  • Begin by hovering over the list in question, and select Setup List Maintenance Program on the More menu.
  • Enter a name for the program, and a description if you like. Click on the add step button, and add a “Change Field Values” step.
  • Enter the Step Name. The first radio button lets you choose a list segment to search for records in, while the second radio button will default to the selected list.
  • On the next screen that appears, click on the “only when clicking the Now button” link to setup the schedule.
  • Set the schedule earlier then the NetSuite/Act-On list sync you setup.
  • Click Save.

If you wish to return to the Programs Listing, click the Listing button. Repeat these steps on any other lists that include the lead score. This list is now fully set up to sync. Its listing will show the NetSuite icon on the left, and the gear icon for the maintenance program and calendar for the scheduled sync on the right.

Sign-ups to NetSuite CRM

Act-On forms can push data directly to NetSuite CRM in Step #2 of the form builder.

Push Sign-up Data to NetSuite CRM when someone submits this form

  • Selecting this option lets you set the system to automatically push submission data into NetSuite CRM. Note that it's very important that your form fields map to your CRM fields; the label must be the same, including spelling and punctuation (watch out for variations such as "e-mail" and "email").
  • If a company record does not exist, an "unaffiliated lead record" will be created.
  • When checking this box, additional options will appear.

Overwrite existing Sign-up Data in NetSuite CRM

  • Electing this option directs Act-On to find the existing record in your CRM database and overwrite the record’s data with the form submission data.
  • If you don’t want all fields to be updated, you can specify only certain fields to be overwritten by selecting Use signup list’s Push settings to select fields.

Add a note to NetSuite CRM

Check this, and Act-On automatically document the user's Activity History noting the form submission.

Email Message Activity Note

When sending a message to a NetSuite connected list, there is an option to attach a note to the contact in NetSuite CRM:

  • Act-On will attach a "Sent email" note in the contact’s activity history, where it can be seen by anyone reviewing the lead.
  • By default the box will be checked and a note will be attached. If for any reason you prefer not to attach the note, just uncheck the box.

NetSuite CRM Saved Search/List View with Act-On Score

With the Act-On Lead Score being pushed to NetSuite, a saved search or a list view can be created that uses the lead score. This will enable the sales team to quickly focus on the most engaged targets.

  • In NetSuite CRM, create a new Saved Search from List Menu Search >Saved Searches.
  • The results will display, sorted by Act-On Lead Score.

Advanced: Permissions

The initial connection between Act-On and Netsuite must be made using administrative user credentials. Going forward, if you wish to connect with a non-administrative role or user, the following permissions, at a minimum, must be granted to the user authenticated to the connector:

Enable Features

In NetSuite, this is located under Setup> Company> Enable Features> SuiteCloud (tab)

  • Enable Server SuiteScript
  • Enable Web Services
  • Enable SuiteSignOn
  • Enable Token Based Authentication

Set Role Permissions/Access

  • Permissions > Lists
    • Companies: View
    • Contacts: Full
    • Customers: Full
    • Contact Roles: View
    • Employees: View
  • Permissions > Setup
    • WebServices: Full
    • Custom Entity Fields: Edit
    • Custom Fields: Edit
    • Custom Lists: Edit
    • Customer Status: Full
  • Forms > Entity
    • Ensure all form options for Type:Contact are enabled
    • Ensure all form options for Type:Customer/Lead/Prospect are enabled

Configuration within NetSuite

Install the Act-On Bundle

  1. Log into your NetSuite Administrator account.
  2. Navigate to the Customization tab.
  3. Select the SuiteBundler, and the Search & Install Bundles.
  4. Search for Act-On
  5. Click Install Bundle and follow the steps.

To install the Act-On Tab:

  1. Go to Customization > Centers and Tabs > Center Tabs and click on New
  2. Label: "Act-On"
  3. Center: All or Marketing Center, as you desire.
  4. In the content categories section, label “Act-On”, and in the Content Portlets section, select Custom PortletColumnCenter, and Show, yes.
  5. Save

Refresh the Act-On Portlet

  1. Click on the Act-On Tab.
  2. On the Custom Content box - click Down Arrow > Set Up.
  3. Choose the source “Act-On Dashboard Portlet"
  4. Save
  1. Navigate to Home > Personalize Dashboard.
  2. Drag the “Custom Portlet” to your desired location.
  3. On the Custom Content Pane you just added, click the down arrow > set-up entry.
  4. Select the “Act-On Hot Prospects Dashboard” and save.
  • Was this article helpful?

Have a question about this topic?

Ask the community!