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!

NOTICE: As part of an updated security policy, Acuity has disabled TLS 1.0 support! Please update your code to use TLS v1.1 or v1.2

Webhooks Webhooks Webhooks

New Feature

This is a new feature, and may change. We'll do our best to give you a heads up if it does!

If you run into any issues, drop us a note at developers@acuityscheduling.com

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