Overview
The Contacts tab on an agency detail page is where you keep track of every person you work with at an agency: who owns the relationship, who legally signs the producer agreement, who handles compliance, and who should receive onboarding emails. It is the single roster that drives invitation emails, signatory routing, and day-to-day correspondence for that agency.
What is the Contacts Tab?
The Contacts tab is the contact directory for one associated agency. It lets you capture each person's name, email, and business role, designate a single primary contact, and decide whether onboarding invitation emails fire when a signatory or primary changes.
Who uses it. Onboarding managers and licensing teams at carriers and MGAs use this tab while standing up a new agency relationship and while keeping an existing agency's roster current. Account managers reference it when they need to know who to email about a renewal, a commission question, or a compliance follow-up.
Key capabilities:
Record every contact at the agency with their First Name, Last Name, and Email, so emails always reach a named person rather than a shared inbox.
Assign one or more Business Roles (Account Manager, Accounts Payable, Compliance Officer, Contract Signatory, Finance Manager, Principal Owner, Support Staff) so the right person is reached for the right topic.
Designate a single Primary Contact who receives onboarding invitations and acts as the default point of contact.
Send a branded onboarding invitation email when you add a contract signatory or promote a new primary, without leaving the tab.
Spot bad email addresses immediately, since rows show an inline warning icon when an email has bounced or is otherwise undeliverable.
See, before you save, exactly what a high-impact edit will do, through a plain-language "What this change will do" caution box.
Accessing the Contacts Tab
Open Left sidebar → Agencies. The Agencies list loads.
Click any agency row to open its detail page.
Select the Contacts tab.
The tab renders a single table of every contact for the agency. The Primary Contact is always sorted to the first row and rendered against a tinted background so it is visually obvious. If no contacts have been added yet, an Unavailable message reading "No contacts assigned for this agency" appears in place of the table.
What's visible on the page:
Column | What it shows |
Name | The contact's full name next to a circular avatar showing their initials. A small "Primary Contact" label sits beneath the name of whichever contact is currently primary. |
The contact's email address. A red warning triangle appears to the left of the address when the email is flagged undeliverable; hover it for a "This email is undeliverable" tooltip. Click the address to copy it to your clipboard. | |
Business Roles | Up to two role badges shown inline. A |
Actions | A three-dot row menu, shown only when you have permission to update or delete the agency. Options: Edit, Set as Primary Contact, Delete. |
To open a contact for editing, click anywhere on the row or use the row menu and choose Edit. The Update Contact slide-over opens with the contact's current details pre-filled.
Note: The three-dot Actions menu only renders when you have permission to manage the agency. Set as Primary Contact and Delete are hidden on the row that is already the primary contact.
Adding a Contact
When you'd do this. A new account manager joins the agency, the agency tells you who their compliance officer is, or you need to capture a dedicated billing contact for commission statements. Adding a contact is also how you put a contract signatory in place before the producer agreement is signed.
Click the Add Contact button above the table.
The Add New Contact slide-over opens with the subtitle "Add a new contact to this agency". Fill in the fields:
Field | Required | Description |
First Name | Yes | The contact's given name. Example: |
Last Name | Yes | The contact's family name. Example: |
Yes | A valid email address. Must be unique within this agency. Example: | |
Business Roles | No | One or more roles selected from the multi-select dropdown. See §Business Roles below for what each role implies. |
Click Add Contact at the bottom of the slide-over.
If you assigned the Contract Signatory role and the agency has reached the contract-signing stage of onboarding, a Send Invitation Email? modal asks whether to email the new signatory. Choose Yes, send email to send them a link to the agency onboarding portal, or No, skip email to add the contact silently. If the agency is not yet at the contract-signing stage, no email is sent and no prompt appears.
The new contact appears in the table immediately.
Tip: Add the Contract Signatory before the producer agreement is generated. The signing envelope is addressed to the signatory's email, so getting the contact in place first avoids voiding and rebuilding an in-flight agreement later.
Note: If you submit an email address that already exists on this agency, the form blocks submission and shows the inline error "Contact with this email already exists" on the Email field.
Editing a Contact
When you'd do this. An existing contact has been promoted, has changed their last name, or has a new email address. You also use this flow to add or remove roles for someone already on the roster.
Click the contact's row, or open the row menu and select Edit. The Update Contact slide-over opens with the subtitle "Update the contact details for this agency".
Update any of the fields below, then click Update Contact. Click Cancel to discard.
Field | Required | Description |
First Name | Yes | The contact's given name. |
Last Name | Yes | The contact's family name. |
Yes | A valid email address. | |
Business Roles | No | Use the multi-select dropdown to add or remove roles, including switching the Contract Signatory assignment. A Select All option is available. |
If you added the Contract Signatory role to a contact who did not have it before, a Send Invitation Email? modal asks whether to email the new signatory. Choose Yes, send email or No, skip email.
Before you save, a "What this change will do" caution box appears at the top of the slide-over whenever your edit has a downstream side effect. It does not block saving; it just tells you what will happen. The notes you may see:
Shared contact: "This person is also a contact in other agency relationships. Saving here updates their details in all of them."
Signatory email change: "This person is the contract signatory. After you save, they will sign in and receive documents at the new email. The old email will stop working for them."
Signatory email change while signing is live: "Because the producer agreement is still being signed, changing the email will restart signing and send a new signing link to the new email."
Primary email change: "This person is the primary contact. After you save, they will sign in at the new email. The old email will stop working for them."
Removing the signatory role: "You are removing the contract signatory role. This person will no longer be able to sign the producer agreement for this agency." (Plus "Any in-progress producer agreement signing will reset." when signing is live.)
Only signatory: "This is the only contract signatory for this agency, so the role cannot be removed. Add another signatory first."
Warning: If the agency has already signed the producer agreement and is awaiting your counter-signature, changing the contract signatory (or the signatory's email) voids the in-flight signing envelope. A modal titled "Agreement Awaiting Counter-Signature" explains that both parties will need to sign again. Click Proceed only if you accept the rework, or Cancel to keep the existing envelope intact.
Setting a Primary Contact
When you'd do this. The current primary leaves the agency, ownership of the relationship transfers internally, or you initially seeded the roster with a placeholder and want to hand control to the right person. The primary contact receives onboarding invitation emails by default.
Open the row menu on any non-primary contact and select Set as Primary Contact.
A modal titled "Send Invitation Email?" asks whether to send an onboarding invitation to the new primary.
Choose Yes, send email to email the new primary a link to the agency portal, or No, skip email to promote them silently.
Only one contact can be primary at a time. Promoting a new primary automatically demotes the previous one, and the demoted contact stays on the roster with their existing role assignments intact.
Deleting a Contact
When you'd do this. A contact has left the agency, or you added them in error.
Open the row menu on the contact and select Delete.
A modal titled "Delete Contact" asks "Are you sure you want to delete the contact "<Name>"?". Click Delete to remove the contact, or Cancel to back out.
The primary contact cannot be deleted: Delete is hidden on the primary row, and if it is somehow triggered, a "Cannot Delete Primary Contact" modal tells you the contact is set as primary and cannot be deleted. Reassign the primary to someone else first, then delete the original.
Business Roles
Each contact can hold one or more of the roles below. Roles are descriptive labels; assigning one does not by itself trigger emails, with one exception: Contract Signatory, which controls who countersigns the producer agreement and drives the invitation-email prompt.
Role | Typical responsibility |
Account Manager | Day-to-day relationship management and operational coordination. |
Accounts Payable | Handles invoices and outbound payments for the agency. (Optional; not required for onboarding completion.) |
Compliance Officer | Oversight of licensing, appointments, and regulatory requirements at the agency. |
Contract Signatory | Authorized to sign the producer agreement and any amendments on behalf of the agency. The producer agreement signing envelope is addressed to this contact. |
Finance Manager | Commissions, payment details, and billing topics. |
Principal Owner | Ownership or executive authority at the agency. |
Support Staff | Operational support contacts who need portal access but do not own decisions. |
Filtering and Searching
The Contacts tab has no dedicated filter controls. Use the page's search box to narrow the table; matching contacts stay visible and the rest are hidden as you type.
The search matches against the Name column (first and last name), the Email column, and the Business Roles column. Partial matches work, so typing comp surfaces every contact tagged Compliance Officer, and typing part of an email or surname narrows the list to that person.
Visual Indicators
Indicator | Where it appears | Meaning | What to do about it |
Tinted row background | Around the Primary Contact row at the top of the table | This contact is the current primary contact for the agency and receives onboarding emails by default. | Nothing required. To move ownership, open the row menu on another contact and choose Set as Primary Contact. |
"Primary Contact" label | Beneath the contact's name in the Name column | Confirms which contact is primary without scrolling to the top of the table. | Same as above. |
Red warning triangle | To the left of the email in the Email column | The email address has been flagged undeliverable (it bounced, was rejected by the recipient mail server, or is on an undeliverable list). | Open the contact and edit the Email field to a valid working address so invitations and reminders get through. |
| After the first two role badges in Business Roles | The contact has more than two roles. | Click the chip to open a popover listing every additional role. Nothing else required. |
Crown badge on Add Contact | On the Add Contact button | Your subscription does not include contact management for agencies. | Click the button to see the upgrade prompt, or contact support@turris.com about enabling the feature. |
Frequently Asked Questions
Why does the Add Contact button show a crown badge? Your plan does not currently include managing contacts for this agency. Clicking the button opens an upgrade prompt instead of the slide-over. Contact support@turris.com to enable the feature.
Why don't I see the three-dot Actions menu (Edit, Delete)? The Actions menu only appears when you have permission to update or delete the agency. If you can view contacts but not manage them, the menu is hidden.
What is the "What this change will do" box in the edit slide-over? It is a non-blocking caution that appears when your edit has a side effect, for example changing a signatory's email or editing a contact who is shared with other agency relationships. It explains what will happen but does not stop you from saving.
What happens when I send an invitation email? The contact receives a branded email with a secure link to the agency onboarding portal. If they already have an account, the link signs them in directly to this agency's record.
Why was the producer agreement voided when I changed the signatory? The signing envelope is addressed to a specific person. Replacing the signatory (or changing their email) while an envelope is in flight invalidates that envelope, so a fresh agreement is generated for both parties to sign.
Can I assign the same contact to multiple agencies? Yes. When a contact is shared across agency relationships, editing them here updates their details in all of them. The edit slide-over shows a caution note when this is the case.
Why is the email column showing a warning icon? The email address has been marked undeliverable, either by an explicit bounce or by appearing in your account's undeliverable list. Update the email so future invitations and reminders are received.
Why can't I remove the Contract Signatory role? The contact is the only contract signatory for the agency, so the role can't be removed until another signatory exists. Add a second contract signatory first, then remove the role.
Best Practices
Designate the primary contact before sending any onboarding emails. Onboarding invitations default to the primary, so getting that assignment right first means the right person sees the agency portal from day one.
Reserve the Contract Signatory role for one person per agency. Multiple signatories complicate the producer agreement envelope, and changing the assignment mid-flight forces both parties to sign again.
Update bounced emails immediately. A row carrying the red warning triangle is silently dropping every email you send. Open the contact, fix the address, then re-send invitations as needed.
Read the "What this change will do" box before saving a signatory or shared-contact edit. It tells you up front whether your change restarts signing or ripples out to other agencies.
Send the re-invitation when promoting a new primary. Choosing Yes, send email in the "Send Invitation Email?" modal gives the new owner an immediate access link to the agency portal.
Related Pages
Agencies — The list of every agency your organization is associated with, with onboarding status and bulk actions.
Agency Overview — The landing page for an individual agency, summarizing onboarding progress, producer agreement status, and coverage by state.
Agency Tab (Agency Detail) — Core profile information (legal name, addresses, contact details, resident-state licensing) for the agency, with an Edit Details action.
Agency Detail: Agents Tab — The roster of licensed agents associated with this agency, with NIPR sync, add/edit/delete, and authorization actions.
Agency Documents — Repository for E&O, Cyber, Crime & Fidelity, W9, and other supporting documents collected during and after onboarding.
Agency Agreements — Every contract on file with the agency, including the producer agreement and supporting contracts, with version history.
Agency Notes — Shared, auto-saving rich-text notebook for free-form context about the agency.
Payment Details — Bank account information used to remit commission payments to the agency.
Agency Detail: Question Responses Tab — The agency's answers to the custom onboarding questions you configured.
Agency Product and State Selection — The matrix of which products the agency is requesting authority for and in which states.
Requested Authority — Side-by-side view of states the agency has requested authority in vs. states where it is already authorized, per product.
AML/OFAC Watchlist Screening — One-time and continuous screening of the agency against AML, sanctions, and watchlist databases.
Agency NIPR Addresses — Every address NIPR has on file for the agency, broken down by state and address type.
Agency NIPR Contacts — Email, business phone, and fax that NIPR has on file for the agency, by state.
Agency Detail: NIPR Continuing Education Tab — Continuing education records reported by NIPR for the agency's agents.
Agency Detail: PDB Report Tab — Producer-Database-style compliance summary assembled from the most recent NIPR sync.
Agency Licenses — Per-product, state-by-state licensing and appointment dashboard for the agency.
Agency Detail: E&O/Cyber Policies Tab — Every E&O, Cyber, and Crime & Fidelity policy assigned to the agency.
Agency Appointments: Agency Tab — Interactive state-by-state command center for managing carrier appointments at the agency (firm) level.
Agent Appointments by State — Per-agent, state-by-state appointments map for the agency's agent roster.
Agency Authority: Agency Tab — State-level selling authority per product at the agency level.
Agency Authority: Agents Tab — State-level authorization for every licensed agent assigned to the agency.
Regulatory Actions — Disciplinary history for the agency and its agents.
Need Help?
If you have questions about the Contacts tab or encounter any issues, contact our support team at support@turris.com.