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.
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.
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.
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.
Check the appointment type name exactly as it appears in Nextech.
Contact Aesthetix CRM support with that name and the category it should have.
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:
In Nextech Cloud, go to Admin > Scheduler > Preferences > Scheduler Module > Online Scheduling.
Set Online Scheduling Appointments: Book to Pending.
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.
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.
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.
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:
Check the Notes tab for the appointment change.
Check the status in Nextech. A visit that was completed but not moved to Fulfilled doesn't update Last Visit Date.
For Last Visit, check whether the patient has a newer fulfilled visit. If they do, Last Visit correctly shows the newer one.
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.
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.
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.
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.
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.
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.
Check Date of Birth. If the contact has no date of birth, the request isn't sent to Nextech at all.
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.
Fix the fields, then remove the nxt-create tag and add it again. The tag only starts Create Patient when it's added.
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.
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.
Field | Notes |
|---|---|
First Name | |
Last Name | |
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.
Field | Notes |
|---|---|
First Name | |
Last Name | |
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.
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.
Check that NXT Birthday is filled in on the contact.
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.
Confirm at least one appointment has been fulfilled for this patient in Nextech.
If NXT Birthday is filled in, a fulfilled appointment exists and Date of Birth is still empty, contact support.
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.
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 | 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 |
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.
Overview of Nextech Practice Plus Integration with 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
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.