Skip to main content

How to Configure Primis Network Integration

Guide for setting up the Primis (Toolbox) network integration, including credentials and data requirements.

Updated this week

Overview

The Primis integration connects Smartr365 to the Primis network's Toolbox platform, enabling fact find data synchronisation, mortgage policy creation, and client linking between the two systems.

Note: This integration is only available for firms within the Primis network.

Before You Start

  • Your firm must be a member of the Primis network

  • You must have an active Toolbox account

  • You need your Toolbox username, API key, and Advisor ID

Credential Setup

Field

Required

Notes

Toolbox Username

Yes

Your login username for the Primis Toolbox platform

API Key

Yes

API authentication key from your Toolbox account

Advisor ID

Yes

Your adviser identifier in the Toolbox system

Steps

  1. Navigate to Settings > My Credentials > Primis

  2. Enter your Toolbox Username

  3. Enter your API Key

  4. Enter your Advisor ID

  5. Click Save

The API key will be masked after saving for security.

Mandatory Data for Submissions

Field

Where to Complete

Notes

Client Details

Fact Find > Personal Details

Full name, DOB, contact details

Employment Data

Fact Find > Employment

Current employment with income details

Income Verifiability

Primis submission form

Confirm if commission, overtime, bonus, and salary are verifiable

Mortgage Details

Case > Mortgage

Product type, buyer type, loan amount

Key Features

  • Fact Find Sync: Push fact find data from Smartr365 to Toolbox

  • Client Linking: Link Smartr365 clients to existing Toolbox clients, or create new ones

  • Mortgage Policy Creation: Create mortgage policies in Toolbox from Smartr365 case data

Troubleshooting

Issue

Solution

Primis option not visible

Check that the Primis feature flag is enabled for your firm

Authentication error

Verify your Username, API Key, and Advisor ID are correct and current

Data sync fails

Ensure the Fact Find is completed with all required fields

Did this answer your question?