The agent mirrors your Acuity appointment types, reads real availability on the call and writes the appointment into Acuity. For the overview, see Acuity Scheduling.
- In Acuity, open Integrations, scroll to API, and copy the User ID and the API Key.
- In Harkbell, as the owner or an admin, select Integrations, then Booking systems, then Connect on Acuity Scheduling.
- Under Connect with your own API key, paste them into User ID and API Key, then select Connect Acuity. If your workspace also shows Sign in to Acuity, you can use that instead and copy nothing.
- Wait while the panel reads your appointment types.
- Rename each one under What the agent says and tick Offer it for the ones callers may book.
- Select Let the agent book into Acuity, then Book into Acuity. At least one appointment type must be ticked first.
No API section in your Acuity?
Acuity ties API access to the plan. If the API section is missing, your plan does not include a key. Upgrade in Acuity, then select Sync now. You can also select Tell me when it is open to be put on the list for another way in. Meanwhile, connect the Google or Outlook calendar Acuity syncs to: the agent then stops offering times you are busy and takes the rest as requests you confirm.
Keep Acuity's clock and Harkbell's the same
If Acuity keeps the account in a different timezone from your Harkbell business, the panel warns you. The agent reads times in your business's timezone while Acuity's own screens and emails use the account's, so the two can name different hours for one appointment. Set both to the same zone.
I regenerated my Acuity API key. What now?
Acuity gives Harkbell nothing to refresh a key with, so a dead key is a fresh key. When Acuity stops accepting the connection, you are told once. Paste the new User ID and API Key and connect again.
Why does a cancellation in Acuity take a while to show up?
On plans where Acuity will not let Harkbell subscribe to changes, the panel says so, and a cancellation made in Acuity can take up to fifteen minutes to appear in the diary. Harkbell still reads real times and makes real appointments.
Does Harkbell store my API key?
It stores it encrypted on the server, and it is never sent to the browser. If you disconnect, the connection and the key are deleted.