Overview
The Agents page is your master roster of every producer writing business across your agencies, so you can see at a glance who is licensed where, run a NIPR compliance pull when their data looks stale, move producers between branches without breaking their history, and pinpoint the few agents whose records are stuck in an error state.
What is the Agents Page?
The Agents page is where you keep your distribution roster current: adding new producers as they sign on, pulling fresh NIPR data when you need to verify licenses or appointments, reassigning agents when they change branches, and retiring producers who have left without losing their history.
Who uses it. Licensing managers, agency operations leads, and principals at carriers and MGAs who need to know which producers are placed at which downstream agencies, whether their compliance data is current, and whether any are flagged with errors. It is the daily working surface for the team responsible for keeping the producer roster clean.
You can:
Confirm which producers are placed at which of your agencies, including agents working under multiple agencies at once
See whether each producer's NIPR license and appointment data is current, in progress, errored, or has never been pulled
Trigger a fresh NIPR compliance pull for one agent or a batch, with the per-agent charge surfaced before you commit
Move producers between agencies in a single operation rather than deleting and re-adding them
Onboard a new agent in seconds by NPN, or load an entire roster from a spreadsheet with AI-assisted column mapping and deduplication
Soft-delete producers who have left and restore them if you change your mind, without permanently losing their data
Drill into any agent's per-state licenses, appointments, authority, and PDB report from a single click
Accessing the Agents Page
Open Left sidebar → Agents. The page loads with the Agents breadcrumb at the top and the active producer roster in the table below.
If your organization's plan does not include the Agents feature, the Agents item is hidden from the left sidebar entirely. Contact your Turris administrator if you believe you should have access.
What's visible on the page:
Element | Description |
New dropdown (top-right, next to the breadcrumb) | Two options: Add Agent (single) and Bulk-Add Agents (file upload via the Agent Ingestion Wizard). Both are disabled when your organization has no agencies yet, with the tooltip "You need to add an agency first". The whole button is hidden if you do not have permission to create agents. |
Filter panel | Sits above the table. Holds the Agency dropdown, the Status badge toggle (Active / Deleted), the Sync Status badge group, an information tooltip, and the Actions dropdown for operations on the current selection. |
Search box | Above the table. Matches against the agent's name and NPN (see Filtering and Searching). |
Table | Sortable, paginated when more than ten rows. Default sort is Agent ascending. Each row has a selection checkbox plus a three-dot Actions menu at the far right (visible only if you have update permission). |
Drilling into an agent. Click anywhere on a row except the selection checkbox or the Actions menu. You land on the agent's detail page, which exposes the Overview, Agencies, Licenses, Appointments, Authority, and PDB Report tabs covered in Related Pages.
If your organization has no agents yet, the page shows a No agents found message: "Agents will appear here once they are added to your agencies." If your filters or search exclude every row, you instead see No matching results: "No agents match your current filters or search. Try adjusting the status filter, agency filter, sync status, or search to see more results."
Agents Table
Column | Description |
Selection checkbox | Click to select an individual row. The header checkbox is tri-state: it selects every agent on the current page, shows a partial state when only some rows are selected, and clears them when all are selected. |
Agent | Avatar with the agent's initials, the agent's full name, and the email shown below the name when one is on file. Sortable. |
NPN | The agent's National Producer Number, rendered in monospaced font. Click it to copy. A dash is shown when no NPN is on file. Sortable. |
Agencies | An agency badge for the first agency the agent belongs to (legal name, with the branch name shown beneath it when it differs). If the agent is placed at additional agencies, a +N more link expands a popover listing each one. |
Compliance Data Synchronization | Color-coded status badge for the agent's NIPR sync. A green cloud-download icon appears next to the badge when sync has not been started and the agent has an NPN on file. A question-mark popover next to the badge reveals the underlying NIPR or processing error message when the status is Error or No Data. |
Actions | A three-dot popover menu offering Update, Delete, or Restore, depending on whether the agent is active or soft-deleted. Visible only if you have update permission. |
Adding a Single Agent
When you'd do this. A new producer has just been hired by one of your agencies and you want them in Turris immediately, so their licenses and appointments start syncing and they show up on every downstream view.
Click New in the top-right and choose Add Agent. The Add Licensed Agent slide-over opens with the subtitle "Select an agency and fill out the form below to add a new agent."
Fill in the form:
Field | Required | Description |
Agency | Yes | Pick the agency (or branch) the agent is being placed at. Branch names are shown in parentheses when they differ from the agency's legal name. |
Find agent by | Yes | Choose NPN (default) or License. This selects how Turris looks the producer up. |
Agent NPN | No | Shown when Find agent by is set to NPN. Enter the producer's NPN to auto-populate their name from NIPR. You can leave it empty and type the name manually. Example: |
License State + License Number | Conditional | Shown when Find agent by is set to License. Both are required in that mode so Turris can resolve the producer's NPN. Example license number: |
First Name | Yes | The producer's first name. Auto-populated (and locked) once Turris resolves the NPN or license; otherwise enter it manually. |
Middle Name | No | The producer's middle name, if applicable. |
Last Name | Yes | The producer's last name. Auto-populated once Turris resolves the NPN or license; otherwise enter it manually. |
No | The producer's email address, used for contact context only. Example: |
Click Add. The slide-over closes, a success alert reads "Agent added successfully.", and the new row appears in the table.
Note: You need at least one agency before you can add an agent. If your roster of agencies is empty, the Add Agent option is disabled and the tooltip reads "You need to add an agency first." Add the agency from Left sidebar → Agencies before returning here.
Tip: If the producer was previously deleted from this agency, you will see an "Agent Previously Deleted" alert instead of a generic error. Use the Status → Deleted filter to find their old record and Restore them rather than creating a duplicate.
Bulk-Adding Agents
When you'd do this. You are onboarding a new agency or migrating producers from another system, and you have their data in a spreadsheet. The bulk-add flow uses AI to map your columns, run validation, check NIPR, and deduplicate against existing producers, so a hundred-row roster does not become a hundred clicks.
Click New in the top-right and choose Bulk-Add Agents. The Bulk-Add Agents wizard (the Agent Ingestion Wizard) opens in a wide modal with a step indicator across the top.
Step through the wizard. The steps run in this order:
Upload the producer file (CSV or Excel).
Column Mapping: confirm the AI-proposed mapping from your columns to Turris fields.
Data Transformation: review any AI-applied cleanups (case fixes, format normalization).
Field Validation: address any rows flagged for missing or malformed required fields. You can mark rows to ignore so they never reach later steps.
Deduplication: review rows that match existing producers and choose how to handle them.
NIPR Validation: keep or drop rows based on NIPR's response for each NPN.
Agency Mapping: while Turris resolves each row to one of your agencies and matches existing agents, a live activity log shows progress. When it finishes, an interactive table lets you confirm each match.
Review: confirm the final batch, then click Submit Import.
When the import is queued the wizard closes. As the job progresses, a success alert appears reading "Bulk upload of agents completed successfully. The table has been updated.", and the table refreshes automatically with the newly added producers.
Tip: If you have to leave the wizard, navigate back to Left sidebar → Agents at any time. The completion alert and table refresh fire from the same background event regardless of which page you are on when the job finishes.
Note: Closing the wizard before you submit cancels the in-progress import so it does not linger on the server. Your file and any work you did in the wizard are discarded, and you start fresh next time.
Re-assigning Agents to a Different Agency
When you'd do this. A producer is moving from one of your agencies to another, or you need to add an existing producer to additional agencies. Re-assigning preserves their history, sync data, and identity rather than forcing you to delete and re-add the producer at the destination.
Tick the checkboxes for every agent you want to re-assign. You can select multiple agents at once.
Click Actions above the table and choose Re-assign to Agency. The Re-assign Agents slide-over opens with a subtitle counting the selection (for example, "Re-assign 3 agents between agencies"). If no rows are selected, the option is disabled and the tooltip reads "Select one or more agents first."
For each selected agent, review the Remove [Agent Name] from checklist. By default every existing source agency is checked, meaning the agent will be removed from each of them. Uncheck any source agency where you want the agent to remain placed.
In the Add To multi-select at the bottom of the slide-over, pick one or more target agencies. The question-mark popover next to the label reminds you that each agency is listed by its legal name, with the branch name shown in parentheses when it differs.
Read the warning at the bottom: "Agents will lose their current authorization status at the source agencies. They will start as unauthorized at the target agencies."
Click Re-assign. The button is disabled until you pick at least one target agency. A success alert reads "N agent(s) successfully re-assigned." If any individual reassignment failed, a "Partially Re-assigned" warning alert lists how many succeeded plus the per-agent error reasons.
Note: Re-assignment does not pull fresh NIPR data. If you want updated licenses or appointments at the destination agency, run Synchronize Compliance Data on the affected agents afterwards.
Synchronizing Compliance Data
When you'd do this. You need an up-to-the-minute view of a producer's NIPR licenses and appointments before doing something license-sensitive (writing a new state, renewing an appointment, signing a producer agreement). Synchronization pulls the current NIPR record into Turris.
You can sync for one agent or for many at once.
Single agent
In the Compliance Data Synchronization column, click the green cloud-download icon next to a Not Started badge. The icon only appears when the agent has an NPN on file and sync has never been initiated.
The Data Synchronisation modal opens, explaining that synchronization charges apply per your contractual terms and that the process retrieves all of the agent's license and appointment data.
Click Synchronize. The badge flips to Queued and then Processing as NIPR responds.
Multiple agents
Tick the checkboxes for every agent you want to sync.
Click Actions above the table and choose Synchronize Compliance Data. If no rows are selected, the option is disabled and the tooltip reads "Select one or more agents first."
Confirm the first Data Synchronisation modal explaining what synchronization does. Click Synchronize to advance.
Confirm the second Compliance Data Synchronization warning modal disclosing the per-agent charge. The action button reads Synchronize N agents (or Synchronize 1 agent for a single selection).
The synchronization runs in the background. A success alert reads "Compliance data retrieval started for N agents." Status badges update as each agent's sync progresses.
Warning: Each NIPR compliance data sync incurs a per-agent charge according to your contractual terms. Selecting hundreds of agents triggers hundreds of charges. Filter the table down (for example, by Sync Status → Not Started) before selecting the bulk-sync target so you do not re-pay for agents whose data is already current.
Note: Very large requests may be capped. When that happens, a "Partial sync started" warning alert tells you how many were queued and how many remain (for example, "60 of 100 agents queued for sync. Repeat to process the remaining 40 agents."). Run the action again on the leftover agents to finish.
Updating an Agent
When you'd do this. A producer's name or email has changed, or you entered the wrong NPN and need to correct it. The Update action is available only on active agents that belong to at least one agency.
Find the agent in the table.
Click the three-dot Actions menu at the end of the row and choose Update. The Update Agent slide-over opens with the subtitle "Update agent details for [Full Name]."
Edit the fields:
Field | Required | Description |
Find agent by / Agent NPN | No | The NPN is editable at any time. Change it to re-resolve the producer against NIPR. You can also switch to License and supply a License State + License Number to look the producer up that way. |
First Name | Yes | The producer's first name. Locked while it shows the synced NIPR value; editable when the NPN is empty or you change it. |
Middle Name | No | The producer's middle name, if applicable. |
Last Name | Yes | The producer's last name. Same locking behavior as First Name. |
No | The producer's email address. Example: |
Click Update to save. If you changed the NPN, a Change Agent NPN confirmation modal appears first ("Changing the NPN will re-sync agent's compliance data. Continue?"); click Change NPN to proceed. The slide-over closes and a success alert reads "Agent updated successfully."
Warning: Changing an agent's NPN re-resolves their identity against NIPR and re-syncs their compliance data. Only do this to correct a genuinely wrong NPN, not to swap one producer for another.
Deleting an Agent
When you'd do this. A producer has left every one of your agencies and you no longer want them on the active roster. Delete is a soft-delete: the record is preserved and the agent can be restored at any time.
Click the three-dot Actions menu at the end of the agent's row and choose Delete.
The Warning: Soft Delete Operation modal opens with the message: "This operation will soft-delete the agent from every agency they belong to. The agent will be marked as deleted but their data will be preserved in the system."
Click Delete to confirm. A success alert reads "Agent deleted successfully" and the row disappears from the Active view.
Note: Deleting an agent removes them from every active agency association in a single operation. If you only want to remove the agent from one agency (and keep them placed at the others), use Re-assign to Agency and uncheck only the agency you want them removed from.
Restoring an Agent
When you'd do this. You soft-deleted an agent by mistake, or a producer has come back to one of your agencies and you want their previous record reactivated rather than re-created.
Set the Status filter to Deleted. The table queries soft-deleted rows separately so your Active dataset is preserved while you work.
Find the agent in the deleted view.
Click the three-dot Actions menu at the end of the row and choose Restore.
The Restore Agent confirmation modal asks "Are you sure you want to restore this agent across every agency they were assigned to?"
Click Restore. A success alert reads "Agent restored successfully", and the row moves back to the Active view.
Selecting Agents for Bulk Actions
Re-assigning and synchronizing both act on whatever agents you have selected. Selection persists as you page through the table.
Use the per-row checkboxes to pick individual agents, or the header checkbox to select or clear every agent on the current page.
When you have selected every row on a page and there are more matching agents on other pages, a banner appears above the table reading "All N agents on this page selected." with a Select all N matching filters → link. Click it to extend the selection to every agent that matches your current filters, not just the visible page.
Use the Clear selection link in the same banner to drop the whole selection and start over.
Warning: If too many agents match your filters to act on at once, the banner instead reads "N agents match these filters - too many to act on at once. Refine the filters and try again." Narrow the Agency, Status, Sync Status, or search filters and try again.
Filtering and Searching
The filter panel sits above the table; use it to narrow the list before selecting rows for a bulk action.
Filter | Type | Purpose | Example use |
Agency | Multi-select dropdown | Show only producers placed at one or more specific agencies (or branches). Matches on the agency's legal name and includes a Select All option. | Auditing the producer roster at a single branch before its quarterly review. |
Status | Single-select badge group | Toggle between Active (green, default) and Deleted (red). The Deleted view runs a separate query so your Active dataset is never overwritten. | Looking for a recently soft-deleted producer to restore. |
Sync Status | Multi-select badge group | Filter by one or more NIPR sync buckets: Not Started (gray), In Progress (blue), Success (green), Not Applicable (gray), or Error (red). The Error bucket also includes "No Data" results. | Selecting Error to find every producer whose last NIPR pull failed or returned nothing, so you can investigate. |
The search box above the table matches against:
The agent's first, middle, and last name (case-insensitive substring)
The agent's NPN (substring: typing
4163finds416344123)
Multi-word queries match across name parts, so typing Michael Mellars finds the agent when one word matches the first name and the other matches the last name. The search box does not match email addresses or agency names; use the Agency dropdown to narrow by agency.
Tip: Hover the information icon at the right of the filter panel for a quick reminder of what each control does. The tooltip reads: "Filter agents by status, agency, or compliance sync status. Active agents are shown by default; toggle to Deleted to view soft-deleted agents."
Compliance Data Synchronization Status
The Compliance Data Synchronization column shows the result of the most recent NIPR pull on the agent's first agency association.
Color | Label | Meaning | What to do about it |
Gray | Not Started | NIPR sync has not yet been initiated for this agent. | If the agent has an NPN on file, click the green cloud-download icon next to the badge (or run Synchronize Compliance Data as a bulk action) to start the sync. If there is no NPN, Update the agent first to add one. |
Blue | Queued | The sync request has been queued and is waiting for a NIPR slot. | No action needed. The status flips to Processing automatically. |
Yellow | Processing | NIPR sync is currently running for this agent. | No action needed. Wait for the badge to flip to Success or Error. |
Green | Success | NIPR returned data successfully and Turris has ingested it. | No action needed. Click into the agent's detail page to inspect their licenses, appointments, and authority. |
Gray | Not Applicable | Sync is not possible for this agent's configuration (typically because they have no NPN). | If the producer should have an NPN, Update them to add it, then re-trigger the sync. |
Red | Error (NIPR error) | NIPR returned an error for this agent. | Click the question-mark popover next to the badge to read the NIPR error message, then run Synchronize Compliance Data again after correcting any underlying issue (for example, an invalid NPN). |
Red | Error (processing error) | Turris's worker hit an error while processing NIPR's response. | Click the question-mark popover to read the error message. If the message is not self-explanatory, contact support at support@turris.com. |
Gray | No Data | NIPR returned no compliance data for this NPN. | Click the question-mark popover to confirm the response. Most often this means the NPN is invalid or the producer is not in NIPR's database. Use Update to correct the NPN, then re-trigger the sync. |
Frequently Asked Questions
Why is the Agents item missing from my left sidebar?
The Agents page is gated by the Agents product feature. If your plan does not include it, the navigation item is hidden. Contact your Turris administrator to confirm your subscription tier.
What is the difference between Add Agent and Bulk-Add Agents?
Add Agent is a guided slide-over that creates one producer at a time and is best when you have a handful of new hires. Bulk-Add Agents opens a wizard that uses AI to map your spreadsheet columns to Turris fields, validate every row, check each NPN against NIPR, and deduplicate against existing producers before committing.
What does soft-delete mean?
A soft-deleted agent is hidden from the default Active view, but their record is preserved in Turris. Switch the Status filter to Deleted to view soft-deleted agents, then use Restore in the row's Actions menu to bring them back. No data is lost.
Can I place the same agent at multiple agencies?
Yes. The Agencies column shows every agency where the producer is placed. If the agent belongs to more than one, a +N more link expands a popover listing each association.
Why is the green sync button missing on some rows?
The inline green cloud-download icon only appears when the agent's sync status is Not Started and an NPN is on file. If the agent has no NPN, run Update to add one before sync can be initiated. If the sync has already started (Queued, Processing, Success, or Error), use Actions → Synchronize Compliance Data in the bulk-action menu to re-trigger it.
Can I change an agent's NPN after they have been synced?
Yes. The NPN is editable at any time in the Update Agent slide-over. Because changing it re-resolves the producer against NIPR and re-syncs their compliance data, a Change Agent NPN confirmation appears before the change is saved. Use this only to fix a wrong NPN, not to swap producers.
How does Re-assign handle agents who currently work at multiple agencies?
In the Re-assign Agents slide-over, every existing source agency is checked, meaning the agent will be removed from each of them by default. Uncheck the source agencies you want the agent to remain placed at before clicking Re-assign.
Why am I being charged for compliance data synchronization?
Each NIPR pull incurs a per-agent charge according to your contractual terms. For bulk syncs Turris surfaces this in two confirmation modals before any charges are incurred, and the final modal shows the exact count of agents that will be billed.
A bulk sync of a hundred agents only queued sixty. What happened?
Very large bulk syncs may be capped per request. When the system caps the batch, a "Partial sync started" warning alert tells you how many were queued and how many remain. Run the action again on the leftover agents to finish the batch.
Best Practices
Use Bulk-Add Agents for onboarding cohorts. When loading more than a handful of producers, the AI-assisted wizard handles column mapping, NIPR validation, and deduplication automatically and is dramatically faster than the single-agent slide-over.
Filter by Sync Status before bulk-syncing. Select only the Not Started or Error bucket so you do not re-pay the NIPR charge on agents whose data is already current.
Re-assign instead of delete-and-re-add. When a producer moves between your agencies, use Actions → Re-assign to Agency so the producer's history and sync data carry over rather than being lost.
Search by NPN when you have it. NPN search uses substring matching, so typing the first few digits is enough to locate a producer in a large roster.
Check the Status → Deleted filter before re-creating a producer. If a producer was deleted from your agencies and is returning, restoring is faster, preserves history, and avoids "Agent Previously Deleted" errors when you try to add them back.
Read the question-mark popover on every red or No Data status. The popover surfaces NIPR's exact error message. Most issues (invalid NPN, no data) can be fixed with a quick Update rather than a support ticket.
Related Pages
Agent: Overview Tab: the default landing view when you open an agent. Pairs identity (name, NPN, email, date of birth) with a snapshot of every agency the producer is placed at in your tenancy.
Agent Detail: Agencies Tab: every agency this producer is on the roster of, how each placement was created, its per-agency sync status, and the entry point for adding the agent to more agencies.
Agent: Licenses Tab: a state-by-state view of which states the agent is licensed in, what each license authorizes, and when each comes up for renewal, pulled from the latest NIPR sync.
Agent: Appointments Tab: every state-level carrier appointment Turris has synchronized from NIPR for the producer, including which are nearing renewal.
Agent: Authority Tab: agency by agency, every product the agent has been requested or approved to write, with a state-by-state license-and-authority map for each product.
Agent Detail: PDB Report Tab: a Producer-Database-style compliance summary consolidating identity, states, licenses, appointments, and regulatory history from the most recent NIPR sync, with a PDF export.
Need Help?
If you have questions about the Agents page or encounter any issues, contact our support team at support@turris.com.