Skip to main content
Complete these steps before relying on automatic attendance earning. Perkstar keeps appointment sync, attendance earning and online reward codes as separate setup stages so each can be verified safely.

​
Before you connect

  • Use Perkstar Growth or higher.
  • Use Acuity Premium or Powerhouse. Acuity documents that API access is available on those plans.
  • Sign in to Perkstar as an owner or manager who can edit operations.
  • Ask the Acuity owner or a Scheduling Administrator to authorise Perkstar. Acuity’s lower contributor levels can be limited to selected calendars; see Acuity access levels.
  • Confirm that you are connecting the intended Acuity account. Perkstar supports one Acuity account per business.

​
Prepare the Stamp card

The card picker shows unarchived active or draft Stamp cards. Points, Cashback and other card types are not eligible. Before going live, confirm that:
  • test earning on a draft if useful, then activate the card before serving customers;
  • the customers you want to reward already exist in Perkstar and are already enrolled on this card;
  • an automatic visit or spend rule is configured;
  • Acuity and Perkstar use the same currency if the card earns by spend; and
  • the expected final, milestone and birthday rewards exist on the card.
A manual earning rule does not credit appointments automatically. Perkstar cannot infer how many stamps a staff member intended to enter.
Check whether this card is also routed to Square. If it is, Square remains the earning owner, including while its connection temporarily needs reconnection, and Acuity will not award attendance a second time. Keep the owner stable while appointment or payment events may still be in flight. Use a new card or contact support before switching an established card between providers.

​
Connect and verify booking updates

1

Open the Acuity connection

In Perkstar, open Settings → Integrations, find Acuity Scheduling and choose Connect.
2

Authorise the complete account

Sign in to the correct Acuity account as its owner or Scheduling Administrator and approve Perkstar’s API access. On return, check the displayed Acuity account, timezone and currency.
3

Verify the Acuity API key if asked

Acuity signs a dynamic webhook with the API key belonging to the user who authorised it. In Acuity, open Integrations, scroll to API, choose View credentials, and copy the API key for that same user. Paste it in Perkstar. Perkstar verifies the user ID and key with Acuity before saving it securely.
4

Confirm booking updates

Perkstar automatically maintains one catch-all appointment.changed webhook. Do not add a Perkstar webhook manually in Acuity. The integration should report that booking updates are connected.
5

Choose the Stamp card

Select the prepared card under Link your stamp card. The selection saves automatically and is applied to open, uncredited Acuity bookings where safe.
Changing the linked Stamp card turns Acuity reward codes off and clears the previous card’s reward-source mappings. Reconfigure the online rewards step before issuing codes from the new card.

​
Configure online reward codes

This stage is optional. Customers can still earn attendance stamps when online reward codes are off.
1

Create the reusable sources in Acuity

Create the coupon or the package, gift or subscription that represents each Perkstar reward. Acuity controls its value, eligible services, usage and expiry. Use separate sources when completed-card, milestone or birthday rewards have different terms.
2

Turn on Acuity codes in Perkstar

Under Let customers use rewards when booking, enable Use Acuity codes for rewards and add the business’s HTTPS Acuity booking page.
3

Match each reward

For every reward you want available online, choose Coupon or discount or Package, gift or subscription, then enter its numeric Acuity reward number. Leave a row blank when that reward should remain in-person only.
4

Create codes for existing rewards

Save the settings. If customers already have eligible unclaimed rewards, use Create existing codes after the mappings are saved.
Acuity explains how to create appointment coupons and how customers use package, gift and subscription codes.

​
Customer information

Perkstar reads only the account and appointment fields required to display and reconcile bookings, match an existing customer and operate a reward code. It does not retain intake-form answers or internal appointment notes. When a reward code is created, Perkstar sends Acuity the configured source, generated code and the customer’s email where available. A configured booking link can prefill the code and the customer’s booking details. The business must tell customers about this provider connection and have an appropriate lawful basis for the data exchange.

​
Test before going live

Use a synthetic customer who already exists in Perkstar and is enrolled on the linked active Stamp card.
  1. Book an Acuity appointment using the same email address and confirm it appears in Perkstar Bookings.
  2. Reschedule it and confirm its service time changes without creating a duplicate booking.
  3. Let a short appointment reach its end time, wait at least 15 minutes and confirm the exact visit- or spend-based stamp credit appears once.
  4. Repeat with phone matching in a different display format and confirm the normalised number resolves the same enrolled customer.
  5. Confirm that a name-only, unmatched or not-enrolled booking does not earn and does not create a customer or enrolment.
  6. Earn one configured reward and confirm the email where deliverable, Wallet reward and one-time Acuity code.
  7. Book with the code and confirm Perkstar records one redemption and removes the used code from Wallet.
  8. Cancel one code booking normally and confirm the reward is restored. Mark a separate code booking as a no-show and confirm its code remains consumed.
Continue with Appointments and rewards.

Related topics

Acuity SchedulingSet up LoyverseSet up SquareAcuity appointments and rewardsAcuity cancellations and troubleshooting