Skip to content
Now onboarding founding practices. Book a walkthrough →
Practice admin

Provider NPI and state licenses

Record each provider's NPI, taxonomy, credentials and state licenses, which decide where they can see telehealth patients.

WherePractice admin › Team › Providers
WhoOwnerPractice admin

The Providers tab holds each provider’s NPI, taxonomy code, credentials and state licenses. Licenses matter for telehealth: a telehealth visit can only be checked in if the provider holds a current license in the state the patient is in.

Before you start

A person appears on this tab once they have the Provider role. If you see “No providers yet. Give someone the Provider role on the Staff page.”, add the role on Team › Staff first.

How to fill in a provider’s profile

  1. Go to Practice admin › Team and open the Providers tab.
  2. Find the provider’s card.
  3. Enter their individual NPI (10 digits).
  4. Enter their Taxonomy code if you use one, for example 207Q00000X.
  5. Enter their Credentials, for example MD, NP or PA (up to 20 characters).
  6. Tick Can bill as rendering provider if claims can list them as the rendering provider.
  7. Select Save profile.

How to add a license

  1. In the provider’s Licenses section, use the add row at the bottom.
  2. Choose the State.
  3. Enter the Type, for example MD, DO, NP or RN (2–10 characters).
  4. Enter the license Number.
  5. Enter the Expires date. Leave it blank if the license has no expiration date.
  6. Select Add license.

Add one license per state. A provider who sees telehealth patients in three states needs three licenses.

License badges

Each license shows a badge:

Badge Meaning
Active Current, with no expiration date on file.
Valid to (date) Current, and more than 60 days from expiring.
Expires (date) Current, but expires within 60 days. Time to renew.
Expired The expiration date has passed. It no longer counts for telehealth.
Revoked Marked revoked. It no longer counts for telehealth.

How to mark a license revoked, or reactivate it

  • Mark revoked stops a license from counting, for example after a provider surrenders a license.
  • Reactivate makes a revoked license count again.

Licenses aren’t deleted, so you keep a history of each one.

Where licenses are checked

  • Telehealth check-in. When a patient joins from the portal, or staff check in a telehealth visit, the patient’s state is matched against the visit provider’s licenses. If there’s no match, the check-in is refused: “The provider isn’t licensed in that state, so this telehealth visit can’t go ahead.” A patient joining from the portal stays Arrived and is asked to call the practice.
  • Virtual care queue. A provider sees new requests only from states they’re licensed in, and can claim only those.
  • Video now. Patients can choose Video visit now only in states where a licensed provider is marked Available now.
  • Scheduled video times on the Get care page come only from providers licensed in the patient’s state.

Good to know

  • A license counts only if it’s active and not past its expiration date. An expired license still shows on the card, but the telehealth check ignores it.
  • When a license is renewed, add the renewed license with its new expiration date, so its badge shows Valid to again.
  • The NPI is checked before it saves. It must be 10 digits with a correct check digit.
  • Two providers in the same practice can’t share an NPI.
  • Your practice’s group NPI goes on Practice › Details, not here.
  • Owners and Practice admins can open this tab.

Troubleshooting

What you see What it means What to do
Not a valid NPI (10 digits with a correct check digit) The NPI has a typo or the wrong number of digits. Copy it again from the provider’s NPPES record.
Taxonomy codes look like 207Q00000X The code isn’t 10 characters ending in X. Fix the code or leave it blank.
Another provider in this practice already has that NPI. That NPI is on someone else’s profile. Check that you’re on the right provider’s card.
Choose a state and enter the license type and number. A required license field is missing. Fill in State, Type and Number.
A telehealth visit won’t check in because of licensing The provider has no current license in the patient’s state. Add or renew the license here, or check that the patient’s state is right.

Still stuck? Contact support and we’ll help. Please don’t include patient information.

Checked against the app on November 14, 2026