Acuity Scheduling

Get Acuity Available Times

Lists the open time slots on one day for an appointment type.

Unverified

What the model is told

Find the free times on a given date for an appointment type. Offer the customer a few of the returned times. Use the exact time value when booking.

Request

GEThttps://acuityscheduling.com/api/v1/availability/times?date={{date}}&appointmentTypeID={{appointmentTypeId}}&timezone={{timezone}}

Headers

  • AuthorizationBasic YOUR_BASE64_ACUITY_USER_ID_AND_API_KEY

Parameters

  • date stringThe date to check, as YYYY-MM-DD.
  • appointmentTypeId stringThe numeric ID of the appointment type.
  • timezone stringThe customer's IANA time zone.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "76e3d7ed-5e11-4f69-96f5-dd0594062241",
    "type": "HTTP_REQUEST",
    "label": "Get Acuity Available Times",
    "name": "get_acuity_available_times",
    "customName": false,
    "description": "Find the free times on a given date for an appointment type. Offer the customer a few of the returned times. Use the exact time value when booking.",
    "parameters": [
      {
        "name": "date",
        "type": "string",
        "description": "The date to check, as YYYY-MM-DD."
      },
      {
        "name": "appointmentTypeId",
        "type": "string",
        "description": "The numeric ID of the appointment type."
      },
      {
        "name": "timezone",
        "type": "string",
        "description": "The customer's IANA time zone."
      }
    ],
    "config": {
      "endpoint": {
        "method": "GET",
        "url": "https://acuityscheduling.com/api/v1/availability/times?date={{date}}&appointmentTypeID={{appointmentTypeId}}&timezone={{timezone}}"
      },
      "headers": [
        {
          "name": "Authorization",
          "value": "Basic YOUR_BASE64_ACUITY_USER_ID_AND_API_KEY"
        }
      ],
      "body": null,
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.