Welcome to the Acuity Scheduling
Developer Hub!



Here you'll find guides and documentation to help you start working with Acuity as quickly as possible, as well as support if you get stuck. Let's jump right in!


Dynamic Webhooks

Acuity's Webhooks API supports creating new webhook subscriptions dynamically. Each subscription consists of an event name, and a target URL, which must be on port 443 or 80. Events supported include:

  • appointment.scheduled
  • appointment.rescheduled
  • appointment.canceled
  • appointment.changed
  • order.completed

Once a subscription is created, we'll notify your server with the appointment ID when the event occurs. Retrieve the full appointment details using our get-appointments API. Existing webhooks can be listed and deleted. Delete a webhook, and we'll leave you alone!

Endpoints:


/webhooks

Webhooks Limit

A maximum of 25 webhooks can be created per Acuity account. A 400 error will be returned when that limit is reached.

POST https://acuityscheduling.com/api/v1/webhooks

>>> 
{
  "event": "appointment.scheduled",
  "target": "https://127.0.0.1/test-create"
}

<<<
{
  "id": 1,
  "event": "appointment.scheduled",
  "target": "https://127.0.0.1/test-create",
  "status": "active"
}

/webhooks

GET https://acuityscheduling.com/api/v1/webhooks

/webhooks/:id

DELETE https://acuityscheduling.com/api/v1/webhooks/:id