company logo

Help Center

Go to Aesthetix CRM
Terms & ConditionsPrivacy Policy
All collectionsIntegrationsNextechNextech Integration Troubleshooting Guide

Nextech Integration Troubleshooting Guide

Use this guide to diagnose and fix the most common Nextech integration issues.

Use this guide to find and fix the most common Nextech integration issues. It covers both Nextech Cloud and Nextech Practice Plus. Where the two work differently, the difference is called out.


Before You Start: Check the Notes Tab

Open the contact record in Aesthetix CRM and click Notes. Every time the integration sends an appointment change from Nextech, it adds a note with the appointment status, type, purpose, practitioner, location, date and category.

  • A note exists: the integration received and processed the change. Go to the section below that matches the problem.

  • No note exists: the change didn't reach Aesthetix CRM. Start with "No note on the contact record" below.

The Notes tab is your audit log. If an appointment change isn't in the notes, Aesthetix CRM didn't receive it.


How the Nextech Integration Works

Unlike EMRs that send updates instantly, the Nextech integration checks Nextech for changes every 5 minutes. Knowing how it decides what to send explains most of what you'll see:

  • Updates appear within 5 to 10 minutes of the change in Nextech, not instantly. Each check overlaps the previous one, so a change isn't missed, and a check that fails is read again by the next one.

  • Only real changes are sent. A change is sent when the status, date or time, patient, practitioner, location, type or purpose changes. Editing an appointment's note in Nextech sends nothing, and a bulk edit of a recurring series comes through once.

  • Only five statuses sync: Pending, Confirmed, Fulfilled, Cancelled and No-Show. Arrived, Checked In, Proposed, Waitlist and Entered in Error are not sent.

  • One change per patient per check. If a patient has several changes at once, they come through one check (about 5 minutes) apart, in pipeline order: cancellations and no-shows first, then pre-op, post-op and follow-up visits, then other visits, and surgery last. A patient with three changes takes about 15 minutes to catch up. During very busy periods, such as a large batch of changes in Nextech, it can take longer.

  • A reschedule shows as two notes: the original appointment cancelled, then the new booking on the next check.

  • An appointment booked and cancelled within a few minutes may come through as the cancellation only, because the integration sends the appointment as it stands when it's read.

Always wait at least 10 minutes (longer if the patient had several changes) before deciding a change didn't sync.


"An appointment was booked in Nextech but the contact didn't move in the pipeline"

No note on the contact record

Wait 10 minutes first. If the patient had other changes at the same time, allow about 5 more minutes for each one.

Check the appointment status. Only Pending, Confirmed, Fulfilled, Cancelled and No-Show are sent. An appointment still in another status (for example, Proposed or Waitlist) doesn't come through until it moves to one of these.

Check the category. If your practice's categorization includes a Block category (admin time, out of office, staff meetings and other non-patient time), appointments in it are not sent at all, by design. If a patient appointment type was put in Block by mistake, contact support to recategorize it.

The appointment type may be new. Every Nextech appointment type is mapped to a category during setup, and we check Nextech weekly for new types. A type added recently may come through with no category, or not appear on the EMR Appointments calendar, until it's mapped.

  1. Check the appointment type name exactly as it appears in Nextech.

  2. Contact Aesthetix CRM support with that name and the category it should have.

  3. Once it's mapped, future appointments of that type sync correctly.

Check the patient's email and phone in Nextech. Placeholder emails (for example, a "no email" address used for patients without one) and invalid phone numbers are not used. A patient with a phone number but no usable email is synced by phone. A patient with neither a usable email nor a usable phone number is not synced at all. Add a real email or mobile number in Nextech, and the next change to their appointment will come through.

For Nextech Cloud: online bookings may need a settings change. If appointments booked through NextPatient online scheduling aren't appearing, the fix is in Nextech's scheduler settings:

  1. In Nextech Cloud, go to Admin > Scheduler > Preferences > Scheduler Module > Online Scheduling.

  2. Set Online Scheduling Appointments: Book to Pending.

  3. Don't change the Hold setting to Pending. That routes appointments to a queue and stops them from syncing.

Several contacts affected over the same period. Contact Aesthetix CRM support right away with the date the issue started and two or three example patients.

A note exists but the pipeline didn't move

The appointment type is miscategorized. This is the most common cause. The note shows the appointment type, purpose and the category it was given. If the category is wrong, the contact moves to the wrong stage or doesn't move. Contact support with the appointment type and the correct category. Don't edit the locked workflows yourself.

The appointment is Pre-Op or Post-Op. These categories update the contact's fields and notes but intentionally don't move the pipeline.

The contact briefly shows Cancelled after a reschedule. The cancellation of the original appointment is sent first and the new booking follows on the next check, about 5 minutes later. After a cancellation, no-show or checkout, the integration also re-sends the patient's next upcoming booking, so the contact ends on the booking. If the contact is still in the cancelled stage after 15 minutes and the patient has an upcoming booking in Nextech, contact support.

The appointment has no category. An appointment type that isn't mapped yet may come through with no category, and then it doesn't move the pipeline. Contact support with the type name.


Pipeline Stage Reference

Surgical Pipeline:

Appointment category

Nextech status

Pipeline stage

Surgical Consult

Pending / Confirmed

Consult Booked

Surgical Consult

Fulfilled

Consult Complete

Surgical Consult

Cancelled / No-Show

Cancelled / No-Show

Surgical Appointment

Pending / Confirmed

Surgery Scheduled

Surgical Appointment

Fulfilled

Surgery Complete

Surgical Appointment

Cancelled / No-Show

Cancelled / No-Show

Non-Surgical Pipeline:

Appointment category

Nextech status

Pipeline stage

Non-Surgical Consult

Pending / Confirmed

Booked

Non-Surgical Consult

Fulfilled

Patient

Non-Surgical Appointment

Pending / Confirmed

Booked

Non-Surgical Appointment

Fulfilled

Patient

Non-Surgical Consult / Appointment

Cancelled / No-Show

Cancelled / No-Show

Pre-Op and Post-Op appointments don't move the pipeline. Block appointments aren't sent.


"Last Visit Date or Next Visit Date didn't update"

Next Visit Date and Next Visit Service update when an appointment is Pending or Confirmed in Nextech. If a patient has several upcoming bookings, the most recently changed one shows until the patient's next cancellation, no-show or checkout. The integration then re-sends their best remaining booking: surgery first, then other visits, then minor visits, and the soonest among those.

Last Visit Date and Last Visit Service update when an appointment is Fulfilled (checked out) in Nextech, and only when it's the patient's latest visit. Checking out an older visit, for example while closing old charts, updates the other fields but leaves Last Visit alone. This is by design.

If either field didn't update:

  1. Check the Notes tab for the appointment change.

  2. Check the status in Nextech. A visit that was completed but not moved to Fulfilled doesn't update Last Visit Date.

  3. For Last Visit, check whether the patient has a newer fulfilled visit. If they do, Last Visit correctly shows the newer one.

  4. If the note exists and none of the above applies, contact support with a screenshot of the note.

Known limitation: if a patient cancels and has no other upcoming appointment, Next Visit Date keeps the cancelled appointment's date. Check NXT Appointment Status to see whether that appointment was cancelled.

Both visit fields store the date only (no time), in your practice's local date.


"A field went blank" or "A field didn't change"

The integration never clears a field. If Nextech sends a value blank (for example, an appointment with no practitioner), the contact keeps whatever value the field already had. If a field you expected to change still shows an older value, check the latest note: the field only changes when Nextech sends a new value.


"The appointment isn't on the EMR Appointments calendar"

Your Nextech appointments are mirrored on a silent calendar named EMR Appointments (one per location for practices with several clinics, med spas or surgery centers). Appointments don't appear on it when:

  • the appointment was created or last changed before October 28, 2026 (it appears the next time it changes in Nextech)

  • it's in your Block category, or its type has no category yet

  • the patient has no usable email or phone number

  • its status isn't one of the five that sync

A rescheduled appointment's original entry shows as Invalid on the calendar, so it doesn't count as a cancellation.

Don't book, edit, move or delete appointments on this calendar. Make the change in Nextech; the calendar follows.


"Patients are getting duplicate texts or emails about their appointments"

Check your own workflows for an Appointment Status trigger with no calendar filter. An unfiltered Appointment Status trigger fires for every appointment synced to the EMR Appointments calendar, as well as for appointments booked on your own calendars. Add a calendar filter so each workflow only runs for the calendars it's meant for. The EMR Appointments calendar itself sends no messages.


"Patient Lifetime Value doesn't look right" (Payments Sync)

Payments sync is optional and separate from the appointment sync. It hasn't changed, and an improved version is being worked on.

For non-surgical and med spa practices: payment tracking generally works well and gives reliable Patient Lifetime Value figures.

For plastic surgery practices: payments sync isn't recommended. Nextech payment data isn't tied to a specific appointment, and credits, payment plans and adjustments often make Patient Lifetime Value inaccurate. If your practice is surgical and seeing unexpected values, contact support to discuss turning payments sync off and assigning opportunity values by hand.


"A patient I added in Aesthetix CRM isn't showing up in Nextech"

How Create Patient works

When you add the tag nxt-create to a contact, the integration searches Nextech first, by email and then by phone and last name:

  • The patient already exists in Nextech: no duplicate is created. The contact is linked to the existing patient, and their Nextech patient ID is written to NXT Patient ID.

  • No match: the patient is created in Nextech, and the new ID is written to NXT Patient ID.

  • It isn't clear who the patient is (several possible matches, or the email belongs to a Nextech patient with a different name): nothing is created, and our team reviews it.

Your confirmation is the NXT Patient ID field. Within a couple of minutes of adding the tag, it should show the Nextech patient ID.

If NXT Patient ID is still blank

  1. Check Date of Birth. If the contact has no date of birth, the request isn't sent to Nextech at all.

  2. Check the required fields for your Nextech product (below). A missing field means the patient isn't created, and the request is held for our team to review.

  3. Fix the fields, then remove the nxt-create tag and add it again. The tag only starts Create Patient when it's added.

  4. Search Nextech by email and phone. If you find the patient, the request may have been held because the match wasn't clear. Contact support with the contact's name so we can link them.

  5. Still nothing? Contact support. Held requests don't show an error on the contact, so we may already have it in our review list.

If adding the tag does nothing at all, your account may use a different tag or trigger from an older setup. Contact support and we'll confirm which one your account uses.

Required fields: Nextech Cloud

Field

Notes

First Name

Last Name

Email

Phone

Date of Birth

The Nextech location the patient is created in, and the ZIP code sent with them, are set by us during setup. There's no location field to fill in on the contact. If your practice has several locations and needs patients created at a specific one, contact support.

Required fields: Nextech Practice Plus

Field

Notes

First Name

Last Name

Email

Phone

Date of Birth

Postal Code (ZIP)

NXT Referral Source

Must match a referral source in Nextech Practice Plus exactly, including capitalization and spacing. We give you the list of values during setup

General Practitioner

Must match a provider in Nextech Practice Plus. At some practices we fill this in automatically during setup, and at others it comes from the contact. We confirm which during setup

Also fill in Street Address, City and State. They're sent to Nextech with the patient.

If Practice Plus patient creation is failing, the most common causes are a missing field and an NXT Referral Source that doesn't exactly match Nextech's values.


"Birthday campaigns aren't firing for Nextech contacts"

The patient's birthday is written to the custom field NXT Birthday on every appointment change. A Birthday workflow copies it into the native Date of Birth field when an appointment is fulfilled, so the native field fills in after the patient's first fulfilled visit since the integration went live.

  1. Check that NXT Birthday is filled in on the contact.

  2. Check whether the native Date of Birth field is filled in. If it's empty, the patient may not have had a fulfilled appointment yet.

  3. Confirm at least one appointment has been fulfilled for this patient in Nextech.

  4. If NXT Birthday is filled in, a fulfilled appointment exists and Date of Birth is still empty, contact support.


"I need to build custom automations on top of the Nextech integration"

The core integration workflows are locked. You can use the fields the integration writes as triggers or conditions in your own workflows:

  • Fields: Next Visit Date, Next Visit Service, Last Visit Date, Last Visit Service, NXT Appointment Status, NXT Appointment Type, NXT Appointment Purpose, Appointment Category, NXT Appointment Date, NXT Appointment Location, NXT Appointment Practitioner, NXT Patient ID, NXT Birthday, Patient Lifetime Value

  • Tags: by default, the Appointments Update workflow adds appt cancelled and appt noshow. Your account's copy may differ.

If you build appointment workflows, filter Appointment Status triggers to the calendars they're meant for. An unfiltered trigger fires for every appointment on the EMR Appointments calendar.

NXT Appointment Status values are pending, booked (Confirmed in Nextech), fulfilled, cancelled and noshow.

If you need a locked workflow customized, or new appointment types categorized, contact Aesthetix CRM support.


When to Contact Support

Situation

What to do

No note after 10 minutes, one appointment

Check the status, category, and the patient's email and phone in Nextech, then contact support

No note, several contacts affected

Contact support right away

Online booking not syncing (Nextech Cloud)

Fix the Online Scheduling setting in Nextech Admin first

New appointment type added in Nextech

Contact support with the type name and the category it should have

Patient appointment type treated as Block

Contact support to recategorize it

Pipeline moved to the wrong stage

Contact support with the appointment type and the correct category

Contact still in Cancelled 15 minutes after a reschedule

Contact support

Patient not created, NXT Patient ID blank

Check Date of Birth and the required fields, remove and re-add nxt-create, then contact support

Payments creating incorrect Lifetime Value (surgical practice)

Contact support to discuss turning payments sync off

Birthday not copying to Date of Birth

Confirm a fulfilled appointment exists, then contact support

Patients receiving duplicate appointment messages

Add calendar filters to your Appointment Status workflows, then contact support if it continues

Locked workflow customization needed

Contact support


Nextech Cloud vs. Practice Plus: Quick Reference

Nextech Cloud

Nextech Practice Plus

Appointment sync

Identical

Identical

Pipeline logic

Identical

Identical

EMR Appointments calendar

Yes

Yes

Patient creation tag

nxt-create

nxt-create

Searches Nextech before creating

Yes

Yes

Patient creation time

Usually a couple of minutes

Usually a couple of minutes

Required fields for patient creation

5 (location and ZIP set by us)

8, plus street address, city and state

Exact-match fields

None

NXT Referral Source, General Practitioner

Category comes from

Appointment type and purpose (the purpose wins)

Appointment type


Frequently Asked Questions

Why do I see two notes for one reschedule? A reschedule in Nextech is a cancellation of the original appointment and a new booking. Each is its own note: the cancellation first, then the booking on the next check.

I used to see the same appointment in the notes two or three times. Is that still expected? No. The integration now sends a change only when something that matters changed. If you see repeated notes for the same appointment with nothing different between them, contact support.

Why did a change take 15 minutes to show up? Each patient gets one change per 5-minute check, so changes arrive in the right order. A patient with three changes at once gets the last one about 15 minutes later.

Why didn't Last Visit Date change when we checked out a visit? Last Visit only moves forward. If the patient already has a newer fulfilled visit, checking out an older one leaves Last Visit on the newer visit.

Why does Next Visit Date show an appointment that was cancelled? When a patient cancels and has no other upcoming appointment in Nextech, Next Visit Date keeps the cancelled date. Check NXT Appointment Status to confirm.

The patient already existed in Nextech. Did adding nxt-create make a duplicate? No. The integration searches Nextech first and links the existing patient instead, filling in NXT Patient ID.


Related Articles

  • Overview of Nextech Cloud Integration with Aesthetix CRM

  • Overview of Nextech Practice Plus Integration with Aesthetix CRM

  • How to Create Patient in Nextech Cloud From Aesthetix CRM

  • How to Create Patient in Nextech Practice Plus From Aesthetix CRM

  • How to Fix Issue with Online Bookings Not Coming into Aesthetix CRM From Nextech Cloud

  • Appointment Category: How It Works and Why It Matters To Your EMR Integration

  • Understanding Next Visit & Last Visit Fields in EMR Integrations


Need Help?

If you've worked through this guide and something still isn't syncing, contact Aesthetix CRM support with the patient's name, the appointment date and a screenshot of the latest note. If you need the integration to do something it doesn't do today, such as a custom field, workflow or location rule, submit a Custom Build Request and our team will scope it with you.

Did this answer your question?
😞
😐
😁