NetSuite Bank Feeds Disconnection & Reconnection Flow

Last updated: September 23, 2025

When disconnecting and reconnecting a NetSuite Bank Feed, it is important to properly mark existing bank feed accounts as inactive before deleting the connection. This ensures that accounts can be recreated with the same names and prevents duplication errors.


Step 1: Mark Bank Feed Accounts as Inactive

Before deleting the connection, mark all bank feed accounts as inactive.
Use the PATCH /bank_feeds/accounts endpoint to update each account’s status.

Why?

  • NetSuite enforces unique names for active FormatProfile records.

  • If you leave accounts in an active state, you may encounter this error upon re-creation

“Active Bank Feed Accounts must have unique names. bf_8b8064f590d5_bb826f57d103 is already in use for an active Format Profile record. Please use a different name.”

By setting accounts to inactive, you free up the account name for reuse.


Step 2: Delete the NetSuite Bank Feeds Connection

Once accounts are inactive, delete the connection either:

  • Via the DELETE /connections endpoint

  • Through the Rutter Dashboard.


Step 3: Recreate Bank Feed Accounts

After deletion, you can recreate bank feed accounts on the new connection:

  • Use the POST /bank_feed/accounts endpoint.

  • Provide the same account name as before.

  • The inactivation ensures no conflicts with NetSuite’s unique-name requirement.


Why Does GET /bank_feeds/accounts Return an Empty Array?

You may notice that GET /bank_feeds/accounts returns an empty array after reconnection. This happens because:

  • The previous accounts still exist in NetSuite but are tied to the old connection.

  • They are not accessible to the new connection.

  • Only after recreating accounts under the new connection will the endpoint return values again.


How do I Mark Accounts as Inactive?

There are two ways to mark a bank feed account as inactive:

Option 1: NetSuite UI

  1. Navigate to: Financial Institutions → Format Profiles

  2. Select the relevant Format Profile.

  3. Set it to Inactive.

  4. Save changes.


Option 2: Rutter Passthrough (SuiteScript RESTlet)

Use Rutter’s passthrough guide for NetSuite:

  • Follow Calling Rutter’s custom SuiteScript RESTlet to deactivate bank feed accounts (reach out to Rutter for the Netsuite Passthrough Guide)

  • NetSuite calls these accounts FormatProfile entities.