Neopolis Appointments: start here
The five-step setup wizard
- Choose reminder type: Remind my customers about their appointments, or Remind me about my appointments.
- Connect & test: choose Built-in Neopolis calendar, Google Calendar, or Outlook / Microsoft 365. For Google or Outlook, follow the provider guide below and run Test calendar connection. It checks the next seven days without sending texts.
- Write your message: start with an example, insert fields with buttons, and watch the live preview.
- Timing & options: choose reminder timing, optional customer actions, branding and notifications.
- Finish setup: review your message and timing, then click Finish setup. The calendar screen opens with reminders paused. The setup test opens next. Choose Done to continue to the SMS enable prompt.
Your unsaved message draft stays in this browser tab while you connect an account. Closing the tab may lose it; save the setup to keep it. Calendar passwords and access tokens are not saved in the draft.
Open My reminder setups to find an existing setup. Use Edit settings for the message and timing, or Open calendar to manage appointments.
Use Neopolis Agenda without connecting another account, or use your existing Google or Microsoft 365 calendar. Neopolis sends appointment reminders, records confirmations and change requests, and provides private details pages. Your dedicated DID must be active and 10DLC approved.
1. Choose where you keep appointments
Open Sign in to Neopolis Appointments and choose New reminder setup. In step 2, select the calendar you want to use.
- For a calendar inside Neopolis, choose Built-in Neopolis calendar, enter a name and color, and click Save calendar details & continue.
- Choose a Sending number and continue to your message and timing.
- Click Finish setup to create the calendar and save the reminder. Use Add appointment to create your first appointment.
To use an existing Google or Outlook calendar, follow the matching guide below.
Connect your own Google or Microsoft account
You do not need developer credentials. In step 2 of setup, choose your provider and follow its walkthrough. These same instructions are available beside the sign-in controls.
How to connect Google Calendar
Connect your own account directly from Neopolis. Keep this browser tab open so the setup can resume when you return from sign-in.
- Start in Neopolis. Open Neopolis Appointments, click New reminder setup if you see it, then choose who should receive reminders. In Choose your calendar, select Google Calendar and click Sign in with Google.
- Choose your calendar account. Use the Gmail or Google Workspace account you use for appointments. Review the calendar access request and approve it. Neopolis reads appointments to show upcoming events and send reminders. Add or edit events in your original calendar.
- Pick one calendar. Back in Neopolis, your connected account is selected. Choose the calendar from Calendar. To switch accounts, use Select a connected account. Pick the calendar where you actually save appointments.
- Check the connection. Choose a Sending number, confirm the timezone shown at the top of the wizard, and click Test calendar connection. A successful result confirms read access and counts appointments in the next seven days. Zero is fine. This check sends no texts and changes no events.
- Set up your text. Click Continue to my message. Write the reminder, choose its timing, and click Finish setup. Your new reminder starts paused. If you want to text your verified phone, choose Send test when the test is ready. Choose Done, then Enable SMS reminders when you are ready.
Add appointments that send reminders
For personal reminders, save an ordinary event on the calendar you selected. For customer reminders, follow these steps in your original calendar:
- In Neopolis, click Copy appointment template from the message step or the saved calendar.
-
Open Google Calendar. Create an event, open its full editor if needed, and paste the template into the description.
- Replace the examples with the customer's mobile number and your required fields. Keep the template labels and markers. Set the title and time, choose the connected calendar, and save. Official instructions for creating an event
Sign-in or calendar access problems
- Wrong account or missing calendar. Sign in with the account that can open the calendar, then select that account again in Neopolis.
- Google says your work or school account is blocked. Ask your organization's Google Workspace administrator to review its third-party app access settings. If Google says Neopolis is unverified or in testing, report the message to Neopolis support.
How to connect Outlook / Microsoft 365
Connect your own account directly from Neopolis. Keep this browser tab open so the setup can resume when you return from sign-in.
- Start in Neopolis. Open Neopolis Appointments, click New reminder setup if you see it, then choose who should receive reminders. In Choose your calendar, select Outlook / Microsoft 365 and click Sign in with Microsoft.
- Choose your calendar account. Use your personal Outlook.com account or the Microsoft 365 work or school account that hosts your calendar. Review the calendar access request and approve it. Neopolis reads appointments to show upcoming events and send reminders. Add or edit events in your original calendar.
- Pick one calendar. Back in Neopolis, your connected account is selected. Choose the calendar from Calendar. To switch accounts, use Select a connected account. Pick the calendar where you actually save appointments.
- Check the connection. Choose a Sending number, confirm the timezone shown at the top of the wizard, and click Test calendar connection. A successful result confirms read access and counts appointments in the next seven days. Zero is fine. This check sends no texts and changes no events.
- Set up your text. Click Continue to my message. Write the reminder, choose its timing, and click Finish setup. Your new reminder starts paused. If you want to text your verified phone, choose Send test when the test is ready. Choose Done, then Enable SMS reminders when you are ready.
Add appointments that send reminders
For personal reminders, save an ordinary event on the calendar you selected. For customer reminders, follow these steps in your original calendar:
- In Neopolis, click Copy appointment template from the message step or the saved calendar.
-
Open Outlook for work or school or personal Outlook Calendar. Create a new event and paste the template into the event body.
- Replace the examples with the customer's mobile number and your required fields. Keep the template labels and markers. Set the title and time, choose the connected calendar, and save. Official instructions for creating an event
Sign-in or calendar access problems
- Wrong account or missing calendar. Sign in with the account that can open the calendar, then select that account again in Neopolis.
- Microsoft shows “Need admin approval”. This comes from your work or school's Microsoft account policy. Use the request option on Microsoft's screen if it is available, or contact your organization's Microsoft 365 administrator. Return to Neopolis and try again after approval. Microsoft consent help
2. Remind me about my appointments
Choose ME to send reminders to the account owner's verified phone. Calendar titles supply the message title. No special description format is needed.
- Name the setup, for example “My appointments.”
- Select its calendar and dedicated sending DID.
- Write your message or click Use default, for example
Reminder: {{Title}} on {{AppointmentDate}} at {{AppointmentTime}}. {{Location}}. - Choose Reminder 1, such as 24 hours before or 8 AM on the appointment day. Optionally choose Reminder 2, such as 1 hour before or another same-day time. Choose the earlier timing first when both settings use the same timing type.
- Click Finish setup, complete or skip the SMS test, then enable reminders when ready.
Personal reminders are exempt from calendar quiet hours and follow Messaging Settings for opt-out footers. Your personal viewer displays the appointment description; keep the link private. Additional recipients receive an SMS invitation and must click Accept before receiving copies. They have read-only access. Remove them to stop copies and revoke their links.
Who receives each personal reminder? For the built-in calendar, reminders go to the creator and the accepted subscribers selected on that appointment. There is no invite-only setting. For connected Outlook or Google calendars, leave invite-based delivery off to send to the owner and every accepted subscriber, or turn it on to match the creator and calendar invite list. Unknown or unaccepted attendees never receive texts. If a provider does not supply a creator, the account owner is used. A creator must be the owner or an accepted subscriber to receive texts. Neopolis Agenda provides a multi-select list of accepted subscribers on personal appointments only; customer appointments always have one recipient. This list selects reminder recipients and does not send email calendar invites.
For either personal reminder, choose a time before the appointment or choose a clock time on the appointment day, such as 8 AM. Use your account timezone. Timed appointment reminders must send before the appointment starts. All-day reminders can also send at 8 AM. If daylight saving time skips a chosen clock time, Neopolis uses the first valid local minute. Two clock times or two offsets must be entered in chronological order. With a same-day clock time for reminder 1, choose a later clock time or an offset under24 hours for reminder 2. For example, 7 AM followed by1 hour before a2 PM appointment sends at7 AM and1 PM. With mixed timings, either reminder can send first. If both reminders are due at the same time, only Reminder 1 sends. With an offset under 24 hours for reminder 1, choose a shorter offset for reminder 2. A first reminder at least one day before can be followed by a clock reminder on the appointment day. Invalid choices are disabled; changing reminder 1 clears an incompatible second choice with a red warning. Previously saved 8 AM-the-day-before schedules are preserved until you choose a new timing option. All-day events remain all-day, but scheduling assumes an 8 AM start in the account owner's saved timezone.
3. Remind my clients about their appointments
Choose CLIENTS. Each appointment has exactly one recipient. Your business must obtain appropriate permission to text at booking; a calendar entry is not proof of consent. Every customer reminder includes the existing configured opt-out footer. A previous STOP always blocks sending.
For the built-in calendar, use Add appointment in Neopolis and enter the name, phone, time and custom fields. For Outlook or Google, create the appointment in your original calendar and paste the Customer appointment template from setup or your saved calendar.
Only information inside [Neopolis]…[/Neopolis] is used for recipient and custom fields. The event's normal start/end and location fields supply the time and address. Missing required fields prevent a reminder; Neopolis does not guess.
Customer reminders due during quiet hours wait until 8 AM in the account timezone, unless an approved exception applies. If that is at or after the appointment start, the reminder is skipped. A requested replacement link can be sent at any hour. Other expired reminder times are skipped.
4. Copyable examples
Configure custom fields once in the setup. Use Add custom field for Doctor, Stylist, Technician or Service. Names ignore capitalization. A required field must be present; optional fields can have a fallback.
General business appointment
[Neopolis]
FirstName: Chris
Mobile: +12105550199
[/Neopolis]
Calendar: October 20, 2026, 10:00–10:30 AM; location 123 Main Street.
Hi {{FirstName}}, this is {{BusinessName}} reminding you of your appointment on {{AppointmentDate}} at {{AppointmentTime}}. {{Location}}Example result: “Hi Chris, this is ABC Services reminding you of your appointment on October 20, 2026 at 10:00 AM (America/Chicago). 123 Main Street” plus the opt-out footer and optional link.
Doctor's office
Add required custom field Doctor; example Dr. Smith. Do not include diagnosis or internal clinical notes in customer-facing fields.
[Neopolis]
FirstName: Chris
Mobile: +12105550199
Doctor: Dr. Smith
[/Neopolis]
Hi {{FirstName}}, this is {{BusinessName}} reminding you of your appointment with {{Doctor}} on {{AppointmentDate}} at {{AppointmentTime}}.Result: “Hi Chris, this is One Star Medical reminding you of your appointment with Dr. Smith on October 20, 2026 at 10:00 AM (America/Chicago).”
Dental appointment
[Neopolis]
FirstName: Jordan
Mobile: +12105550198
Doctor: Dr. Patel
[/Neopolis]
Hi {{FirstName}}, your appointment with {{Doctor}} at {{BusinessName}} is on {{AppointmentDate}} at {{AppointmentTime}}. {{Location}}
Salon appointment
Add required Stylist; optionally Service with fallback “appointment.”
[Neopolis]
FirstName: Alex
Mobile: +12105550197
Stylist: Jamie
Service: haircut
[/Neopolis]
Hi {{FirstName}}, your {{Service}} with {{Stylist}} at {{BusinessName}} is on {{AppointmentDate}} at {{AppointmentTime}}.
Home service appointment
Add Technician. Put the service address in the calendar's Location box.
[Neopolis]
FirstName: Taylor
Mobile: +12105550196
Technician: Morgan
[/Neopolis]
Hi {{FirstName}}, {{Technician}} from {{BusinessName}} is scheduled for {{AppointmentDate}} at {{AppointmentTime}}. Address: {{Location}}
Personal reminder with copies
No Neopolis block is required. Title: “Meet accountant”; location: “100 Example Street.” Choose 24 hours and 1 hour. Invite an additional person using their calendar email and phone, then wait for ACTIVE. Copies are not appointment-management permissions.
All-day appointment
A calendar event dated October 20 is scheduled as 8 AM October 20 for reminders. A 24-hour reminder goes out at 8 AM October 19. SMS and viewer still say “All day”; the original event is unchanged.
Four businesses
Connect the required accounts. Create four named setups and select the correct calendar and sending DID for each. Use different business names, templates and timing. Duplicate creates a paused copy. Overlapping setups cannot send the same occurrence/recipient/reminder slot twice.
5. Test and enable reminders
- Click Finish setup. The new reminder is paused.
- When the test is ready, choose Send test if you want a sample on your verified phone. Normal SMS charges apply.
- Click Done. Choose Enable SMS reminders to start sending or Not now to leave the reminder paused. You can enable it later from Calendar settings.
Open your calendar to add appointments. For Google and Outlook, edit or delete appointments in the original calendar. Check SMS reminder logs to see delivery or skip reasons.
6. Details pages and customer responses
Details links last 60 hours from issuance. After expiration the recipient can request a replacement, sent to the original phone, at most once per 15 minutes and five times within a rolling 24-hour period per recipient on your account. Removed recipients, opted-out recipients, deleted setups and unavailable appointments do not receive replacements.
Customer action pages can display your business name, image or both, with a Powered by Neopolis SMS credit. Logos must be genuine PNG/JPEG under 2 MB and at most 2000 × 2000; they are re-encoded and fitted proportionally inside 480 × 160.
Enable any combination of Confirm, Request cancellation, and Request rescheduling. Opening a link never changes status. Requests do not change your calendar: update Neopolis Agenda or the connected calendar yourself. You can choose emails for each response type. Customer viewers show time, location and explicitly configured custom fields, never unmarked internal notes. Personal viewers show full text descriptions. Attachments are not included.
Links are private bearer links: anyone receiving a forwarded link may use it before expiry. Do not put sensitive information in customer-facing fields. This feature is not represented as HIPAA-ready; regulated use requires a separate review of agreements and safeguards.
7. What happened to my reminder?
These are possible reasons a reminder may not send. This guide is not reporting errors on your account; check SMS reminder logs for an actual result.
- Missing Mobile or DoctorCorrect the marked block in Outlook/Google or enter the appointment through Neopolis. Use one mobile number and one value per field.
- Reminder time passedThe appointment was added too late, reminders were paused, or an outage lasted beyond the short dispatch window. The reminder is skipped; no stale backlog is sent.
- Quiet hoursCustomer reminders due from 9 PM to 8 AM wait until 8 AM in the account timezone. If the appointment starts at or before that delayed time, the reminder is skipped. Personal reminders are exempt; approved customer exceptions keep their original send time.
- Insufficient fundsAdd funds in Billing. Skipped reminders are not automatically replayed. Configure the email-only low-balance alert in Messaging Settings; default threshold $10.
- Recipient opted outDo not remove suppression or change the number to bypass STOP. Follow the established resubscription process.
- Calendar disconnected or permission errorCheck the sign-in and calendar access instructions for your provider.
- Duplicate appointmentThe same calendar occurrence, recipient and reminder slot is tracked once across setups. A genuinely separate event is a different appointment; do not create duplicate calendar events.
- Appointment changed after sendingRescheduling to a future appointment time creates a new reminder schedule when its send time is still in the future. Repeated scans do not resend the same schedule. Cancelled or removed appointments stop pending sends.
- Appointment changed while queuedThe old queued message is rejected and the held messaging funds are returned, so outdated details are not sent. Check history and provider calendar.
Need help?
Include your setup name and the reason shown in history. Never send calendar credentials, API secrets or private appointment details unnecessarily.
Get help from support ↗