Lister les rendez-vous avec l'API Acuity Scheduling

Liste les rendez-vous du compte, du plus récent au plus ancien par défaut, jusqu'à max par appel. Il n'y a pas de jeton de page : quand un appel renvoie max rendez-vous, restreignez minDate et maxDate. Les rendez-vous annulés ne viennent qu'avec canceled ou showall.

Identifiant
acuity_list_appointments

L'appel

POST https://connect.reportei.com/api/tools/acuity_list_appointments/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "minDate": "<minDate>"
  }
}

Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.

Paramètres

Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.

ParamètreTypeObligatoireDescription
minDatestringNonOnly the appointments on this date or after, such as 2026-11-01.
maxDatestringNonOnly the appointments on this date or before, such as 2026-11-30.
calendarIDintegerNonOnly the appointments on this calendar: an id from List calendars.
appointmentTypeIDintegerNonOnly the appointments of this type: an id from List appointment types.
canceledbooleanNontrue for only the canceled appointments.
showallbooleanNontrue for the canceled and the scheduled appointments together.
firstNamestringNonOnly the appointments of clients with this first name.
lastNamestringNonOnly the appointments of clients with this last name.
emailstringNonOnly the appointments of the client with this email address.
phonestringNonOnly the appointments of the client with this phone number.
excludeFormsbooleanNontrue to leave the intake form answers out of the response, which makes it faster.
directionstringNonOrder by date. The default is DESC, newest first.Valeurs : DESC, ASC
maxintegerNonMaximum number of appointments to return. The default is 100.

Connexions possibles

Votre client connecte son compte Acuity Scheduling une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.

Identifiant et mot de passe

Votre client saisit les identifiants de l'app sur un écran de Connect, ou votre système les envoie avec POST /api/customer-toolkits, sans écran.

La réponse

En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.

Prête pour les agents IA

L'input de cette tool est un JSON Schema, disponible via GET /api/tools/acuity_list_appointments. Il devient la définition de tool de votre agent sans conversion.

Autres tools Acuity Scheduling

Voir les 13 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.