Schedulista allows your clients to schedule appointments on their own online when you want to be available to offer services. While scheduling, some basic information about the client is used to create a client record that you can reference for their appointment history.

You can automatically share select appointment information with other software using our one-way webhook API.

Note: The Schedulista webhook API is in beta testing at the moment. Functionality could change during testing.

What is a webhook API?

An application programming interface (API) allows two pieces of software to communicate with each other. APIs typically require a request (a "pull") from one software to initiate a response (a "push") from the second software.

A webhook API (or push API) makes information from one software available without requiring a request from another software. This is often referred to as "pushing" information.

The webhook API is a one-way share: It will only share information to another software. It won't receive information from the other software.

About Schedulista's webhook API

The webhook API is a beta release and is subject to change.

Our webhook API has not been publicly released. You can request access by emailing us at support@schedulista.com or contacting us through the chat at Schedulista.com or on the Settings tab in the Schedulista mobile app.

It will automatically push select appointment information from Schedulista to another connected software in any of three events:

whenever an appointment is scheduled (booked) through the online scheduler or set by a provider directly on their calendar or another provider's calendar
whenever an appointment is cancelled
whenever an appointment is updated; updates include rescheduled date and/or time, change of provider, change of service, change of duration.

Connection to another software requires a webhook URL. This webhook address can be provided directly from the other software or can be provided through a third-party connection/integration service like Zapier (see more below).

You can set up multiple webhooks to connect to more than one software.

Webhook payload - what's included

Some information for you technical folks. We perform an HTTP POST with the following JSON payload each time an appointment is scheduled, updated, or cancelled.

{  
 "occurred_at": "2017-10-16T16:13:54-0700",
 "event_type": "appointment:scheduled",
 "appointment": {
   "id": "a1079318069@schedulista.com",
   "time": "2017-10-16T04:30:00-0700",
   "duration": 120,
   "service": {
     "name": "Women's Haircut & Style"
   },
   "client": {
     "first_name": "Felix",
     "last_name": "Livni",      
     "email": "support@schedulista.com",      
     "phone": "+18004191672"   
   },    
   "provider": {      
     "first_name": "Casey",      
     "last_name": "Roberts",      
     "email": "casey.roberts@gmail.com"   
   },    
   "actor": {      
     "first_name": "Stephen",      
     "last_name": "Anderson",      
     "email": "stephen.anderson@gmail.com"    
   }
 }
}

All times are ISO 8601 format with a time offset that matches the time zone offset of the business (at that time).
occurred_at is the time the appointment was booked or set
event_type is the action taken in Schedulista. Three event types are available: "appointment:scheduled", "appointment:updated", "appointment:cancelled"
appointment.id is a unique identifier for the appointment
appointment.time is the date & time of the appointment
appointment.duration is the length of the appointment in minutes
appointment.service is the name of the service booked
appointment.client is the most recently added / updated client for this appointment. This includes the client's name, the client's email address, and the client's phone number. In the future we plan to list all attendees for appointments that are classes.
appointment.provider is the calendar that the appointment was booked on. This includes the provider's name and the provider's email address (only if the provider has an email address on their user account).
appointment.actor is the user or provider who performed the action. This section is only included if the actor differs from the provider. (e.g., another provider on the account sets an appointment on your calendar) This includes the actor's name and the actor's email address (only if the actor has an email address on their user account).
custom_fields includes all responses to any custom fields on the appointment

Current limitations

The webhook API is a one-way share; information cannot be imported into Schedulista from other software via the webhook API.
HTTP POST only
No data validation signature

Zapier

The webhook API is compatible with Zapier, a service that allows you to connect other web services and apps you use to create automated workflows they call "zaps." You can read more on setting up the webhook as a trigger for a zap here.

Entering your webhook URL

You will get a webhook URL from another software you would like to connect with Schedulista or from a connection/integration service like Zapier.

You can enter your webhook URL on the Webhooks page in your account settings.

Note: Webhooks can currently only be set up on the web app.

(1) Go to Settings > Webhooks

(2) Click Add Webhook

(3) Enter a name or brief note for the webhook in the Description field

(4) Enter the webhook URL in the URL field

(5) Select which Event types you would like to support. You can select one or multiple types.

(6) Click Save

Repeat these steps to add additional webhooks for other software.

Information about a webhook

On the Webhooks page, you will see each of your webhooks listed. Each webhook will display the following information:

Description (name)
Webhook URL
Event type(s) selected
Date and time of the last successful webhook event push
Total number of events pushed to date

Disabling a webhook

You may want or need to temporarily disable a webhook from firing without permanently deleting the webhook setup.

(1) Go to Settings > Webhooks

(2) Scroll down to the webhook on the list you want to disable

(3) Click Edit

(4) On the webhook details page, check the Disabled box

(5) Click Save

When a webhook is disabled, a red Disabled tag will replace the event type(s) displayed on the webhook in the list on the Webhooks page.

Re-enable

To re-enable a webhook, edit the webhook, uncheck the Disabled box, and click Save.

Note: Schedulista may auto-disable a webhook if multiple failures are reported. You (or the main administrator on a multi-user business account) will be notified by email if the webhook is auto-disabled. Once you have resolved any issues with the webhook in the other software, you can re-enable the webhook in Schedulista.