Skip to main content

Appointments: Actions Required

Written by Sven Gerlach

Overview

The Actions Required tab is a single prioritized worklist of every agency, agent, state, and product combination on your book where an appointment, authorization, or licensing step is blocking compliant production. It is where your team starts the day to clear those gaps one row at a time, taking the exact carrier-side action each row is eligible for without hunting through individual entity profiles.

What is Actions Required?

Actions Required scans every association you have with a downstream agency or agent, walks each product and state they are configured for, and surfaces only the rows that are not in a clean licensed, authorized, and appointed posture. For each row it offers the one or two actions that will move it back toward compliant, and it removes the row once that action resolves the gap.

Who uses it. Licensing, contracting, and operations managers at carriers and MGAs who own the running backlog of new appointments, renewals, terminations, and authorization changes across their entire downstream network.

What you can do here:

  • Work a single ranked list of every agency-level and agent-level appointment gap, with the soonest renewals near the top.

  • Read each row's license, authorization, and appointment status side by side, without opening the entity's profile.

  • Launch only the action a row is actually eligible for from a per-row menu, so you never file a request a carrier or state would reject.

  • Confirm each action in a modal that names the state, product, and the required-versus-current status before anything is submitted.

  • See the row drop off automatically once the action clears the gap, and stay visible with a yellow badge while a request is still in flight.

Accessing Actions Required

  1. Open Left sidebar → Appointments. The Appointments page loads with the Actions Required tab selected by default.

  2. The tab strip at the top of the page lists four views: Actions Required, Appointments Requests, Agencies, and Agents. Click Actions Required (or open the page with no tab in the URL) to load this worklist.

Note: Appointments is a premium feature. Organizations without the Appointments product enabled see an upgrade prompt instead of the table, and organizations that are not yet paying customers see a Become a Customer message in place of the worklist.

What's visible on the page:

Column

What it shows

Category

A neutral badge reading Agency (a downstream entity) or Agent (an individual producer).

Name

The entity's legal name. For an agent, the producer's name is on the top line and the agency they are appointed through is shown beneath it in muted text.

State

The state or US territory the row applies to, shown as a circular state badge.

Product

The carrier product the row is scoped to. Every row is specific to one product.

License

The entity's license status for the line of authority this state and product require: Licensed, Expiring, Expired, or Not Licensed. Hover the column header for the hint, "Indicates whether the individual or entity has the required license and LOA to sell that product in that state."

Authorization

Whether the carrier has approved the entity to sell this product in this state: Authorized or Unauthorized. Hover the column header for the hint, "Indicates whether the individual or entity has been approved to sell that product in that state."

Appointment

The current appointment status (Appointed, Expiring, Expired, Not Appointed) or, when a change request is in flight, the live request status (such as Pending or Submitted) with a tooltip naming the active request.

Actions

The three-dot menu (at the right end of the row) listing the actions valid for that row's current status. This column appears only for users whose role grants update permission on Appointment Management.

The list is ordered by upcoming renewal date by default, with the most urgent renewals near the top. The page returns the full worklist at once and paginates in your browser; use the page-size selector and page controls at the bottom of the table to move through it.

Resolving an Action Required Row

When you'd do this. Each morning, or whenever you are alerted that an appointment or license is expiring, you work down the table and clear the most urgent rows. The menu only offers the actions a row's status combination allows, so following the menu keeps you from filing requests carriers or state insurance departments would reject.

  1. Find the row you want to act on. The list is fixed in renewal-date order; there is no column sorting on this tab.

  2. Click the three-dot Actions menu at the right end of the row. The menu lists only the actions valid for that row:

Action

When it appears

Request Appointment

License is Licensed or Expiring, the state is Authorized, the entity is Not Appointed, and no other request is in flight.

Renew Appointment

License is Licensed or Expiring, the state is Authorized, the appointment is Expiring or Expired, and no other request is in flight.

Terminate Appointment

The entity is Appointed, or its appointment is Expiring or Expired, and no other request is in flight.

Authorize

The entity is Unauthorized in the state and is Licensed or Expiring.

Unauthorize

The entity is currently Authorized. The menu item is styled in red because it removes the carrier's authorization.

Note: Actions that change an appointment (Request, Renew, Terminate) are withheld for a row while a change request is already in flight, so you cannot stack conflicting requests. Authorize and Unauthorize can still appear during an in-flight request because they act on the authorization, not the appointment. If no action applies to a row, the Actions cell is empty.

  1. The Action Requirement modal opens. The heading shows the action title followed by a State: label with a neutral badge naming the state, and a Product: label with a primary-colored badge naming the product, so you can confirm the scope before submitting.

  2. The modal body lists the required value next to the current value for License Status, Authorization Status, and Appointment Status, followed by a short italic sentence describing what the action will do:

Action

Description shown

Request Appointment

"A new appointment request will be submitted."

Renew Appointment

"The existing appointment will be renewed."

Terminate Appointment

"The appointment will be terminated and authorization status will change to unauthorized."

Authorize

"Authorization will be granted."

Unauthorize

"Authorization will be revoked."

  1. Click Proceed to submit, or Cancel to close the modal without changes. While the request is submitting, the button shows Processing... and is disabled.

  2. On success the modal closes, a confirmation alert appears (for example, "Appointment requested successfully" or "Successfully updated state authorization for [State]"), and the worklist refreshes. Rows that no longer need action drop off; rows that now have a request in flight stay visible with a yellow appointment badge until the request resolves. If the action fails, an error alert appears and the modal stays open so you can retry.

Tip: Read all three status badges (License, Authorization, Appointment) before opening the menu. The available actions are gated on the combination, so the badges tell you in advance which action you'll be offered.

Filtering and Searching

The Actions Required tab is deliberately a single ranked worklist. Unlike the other three Appointments tabs, it has no filter dropdowns, no search box, and no clickable column sorting; the only list control is pagination.

Control

Type

Purpose

Example use

Page size

Selector at the bottom of the table

Show more or fewer rows per page (10 to 50).

Bump the page size to 50 to clear a large weekly backlog in fewer page turns.

Page controls

Previous / next buttons at the bottom of the table

Move through a long worklist.

Page through several thousand rows during a weekly cleanup.

To slice the work by product, agency, agent, or by request status, switch to the Agencies, Agents, or Appointments Requests tab, each of which exposes its own filter dropdowns.

Visual and Status Elements

Each row carries three colored status badges. Read all three together, because the actions you can take are determined by the combination.

License Status badge:

Color

Label

Meaning

What to do about it

Green

Licensed

The entity holds all required licenses and lines of authority for this state and product.

No license action needed. The row is here because of an authorization or appointment gap.

Yellow

Expiring

A required license renews within the next 60 days.

Have the agency or agent renew the license soon; Request, Renew, and Authorize actions still apply while the license is valid.

Red

Expired

A required license has passed its renewal date.

The state license must be renewed. Only Terminate is offered for an existing appointment; Request, Renew, and Authorize are withheld until the license is valid again.

Red

Not Licensed

A required license or line of authority is missing.

Resolve licensing first. The only appointment action available is Terminate, if an appointment exists despite the missing license.

Neutral

Unknown

The license status could not be resolved.

Open the entity's profile to investigate.

Authorization Status badge:

Color

Label

Meaning

What to do about it

Green

Authorized

The carrier has approved the entity to sell this product in this state.

No authorization action needed; use Unauthorize only when you intend to revoke it.

Red

Unauthorized

The carrier has not authorized the entity in this state.

Use Authorize once the entity is Licensed or Expiring to grant approval.

Neutral

Unknown

The authorization status could not be resolved.

Open the entity's profile to investigate.

Appointment Status badge:

Color

Label

Meaning

What to do about it

Green

Appointed

The entity has an active appointment for this state and product.

The row appears because of a license or authorization gap; resolve those, or use Terminate if the appointment should end.

Yellow

Expiring

The current appointment renews within the next 60 days.

Use Renew Appointment before the renewal date passes.

Red

Expired

The appointment's renewal date has already passed.

Use Renew Appointment to continue the relationship, or Terminate Appointment to end it.

Red

Not Appointed

No active appointment exists for this state and product.

Use Request Appointment once licensing and authorization are in place.

Yellow

Request status (such as Pending or Submitted)

A change request is in flight. The badge shows the request's status, with a tooltip reading "You have an active request for [appointment / termination / renewal / loa change]".

Wait for the request to complete, or open the Appointments Requests tab to monitor or cancel it.

Neutral

Other

The appointment status could not be resolved.

Open the entity's profile to investigate.

Frequently Asked Questions

Why doesn't the Actions Required tab have filters like the other Appointments tabs?

It is intentionally a single ranked worklist so you can clear gaps from top to bottom without slicing the list first. Use the Agencies, Agents, or Appointments Requests tab when you need to filter by product, agency, agent, or request status.

Why are agencies and agents mixed together in one table?

The list reflects every gap that needs work, regardless of entity type. The Category column marks each row as Agency or Agent, and each action is routed to the correct agency-level or agent-level request automatically when you confirm.

Why is the Actions column missing from my view?

The Actions column appears only for users whose role grants update permission on Appointment Management. Read-only users see the same rows and statuses but cannot launch actions from them.

What happens after I confirm an action?

The request is submitted, the modal closes, a confirmation alert appears, and the worklist refreshes. Rows that no longer need action drop off; rows that now have a request in flight stay visible with a yellow appointment badge until the request resolves.

Why does a row show a yellow appointment badge but no Request, Renew, or Terminate option?

A yellow badge means a change request is already in flight for that state and product. The appointment-changing actions are withheld so you do not stack conflicting requests. Use the Appointments Requests tab to view, monitor, or cancel the pending request.

Why can't I authorize an entity that has no license in the state?

The Authorize option only appears when the entity's license is Licensed or Expiring. If the license is Expired or Not Licensed, authorization is not offered until the licensing gap is resolved.

Does terminating an appointment also change authorization?

Yes. The confirmation modal states that terminating the appointment also changes the authorization status to unauthorized for that state and product, and the modal's required-versus-current values reflect that outcome before you confirm.

Best Practices

  1. Treat Actions Required as your standing daily worklist. Working it from the top keeps the soonest-renewing appointments visible and prevents lapses from sliding into Expired.

  2. Read all three status badges before opening the menu. The available actions are gated on the License, Authorization, and Appointment combination, so the badges tell you what to expect and prevent surprise.

  3. Resolve license and authorization gaps before requesting appointments. The menu only offers Request when License and Authorization are clean; clearing them deliberately heads off downstream rejections from carriers and state insurance departments.

  4. Verify the state and product badges in the confirmation modal. Each action is scoped to one entity, one state, and one product. The badges in the modal heading are your last chance to catch a misclick before it reaches a carrier.

  5. Use the appointment badge color to triage. Yellow rows already have a request moving through Appointments Requests; focus team effort on the red rows (Expired, Not Appointed, Unauthorized) that no one is actively working.

Related Pages

  • Appointments: Appointments Requests Tab — The single ledger of every appointment, termination, renewal, and line-of-authority change request, tracked from Pending to Completed.

  • Appointments: Agencies Tab — A per-agency grid of appointment status across products, with filters and bulk request, cancellation, and termination tools.

  • Appointments: Agents Tab — The agent-by-agent view of appointment status across products, with bulk appointment, cancellation, and termination tools.

Need Help?

If you have questions about Actions Required or encounter any issues, contact our support team at support@turris.com.

Did this answer your question?