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