API keys and webhooks

If you have your own website, CRM or back-office system, you can connect it directly to your BookAppointment account.

Create a key

1. Sign in and open API & webhooks under Settings. 2. Choose New key, name it after the system that will use it, and tick only the permissions it needs. 3. Copy the key straight away — for your security we only store a scrambled copy and can't show it again. Lost it? Revoke it and create another.

What you can do

Send your key as a bearer token to https://bookappointment.co.uk/api/public/v1:

• GET /bookings — appointments in a date range
• POST /bookings — create an appointment
• GET /services and GET /staff — your services and team

Get told when things change

1. Choose New webhook and paste the https address that should receive the message. 2. Tick the events you care about: new booking, changed booking, cancellation, new customer or successful payment. 3. Use Test to send a sample straight away, and check Recent deliveries to see what we sent and what came back.

Every message is signed with your endpoint's secret in the x-bookappointment-signature header, so your system can confirm it really came from us.

API access and webhooks are included on the Business package.