Acuity Scheduling

Get Acuity Available Dates

Lists the days in a month that have openings for an appointment type.

Unverified

What the model is told

Find which days have availability for an appointment type in a month. Ask the customer which month suits. Then call Get Acuity Available Times for a chosen day.

Request

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

Headers

  • AuthorizationBasic YOUR_BASE64_ACUITY_USER_ID_AND_API_KEY

Parameters

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

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "216d779b-6188-45a3-b591-d714bbe6268f",
    "type": "HTTP_REQUEST",
    "label": "Get Acuity Available Dates",
    "name": "get_acuity_available_dates",
    "customName": false,
    "description": "Find which days have availability for an appointment type in a month. Ask the customer which month suits. Then call Get Acuity Available Times for a chosen day.",
    "parameters": [
      {
        "name": "month",
        "type": "string",
        "description": "The month to check, as YYYY-MM."
      },
      {
        "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/dates?month={{month}}&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.