What are Webhooks?
Webhooks are HTTP callbacks which can be used to pull information from Appointedd. Appointedd's webhook integration allows you to send data about an event when that event is triggered e.g. when a new booking is created, updated or deleted.
Webhooks are currently processed on the following events:
- Booking created
- Booking updated
- Booking cancelled
- Customer created
- Customer updated
- Customer deleted
Note: Bookings can also trigger customer webhooks, as customers can be updated and created while creating a booking.
Creating a Webhook
You can create a Webhook from your Appointedd settings:
- Hover over the integrations tab
- Select Webhooks
- Give your Webhook a comprehensive name
- Select a Webhook trigger
The trigger is the action which will prompt the webhook to send information to the URL.
- Enter the URL of the endpoint to which data should be sent
This article explains how you can use Zapier to catch your webhook and send the information to your other tools.
- If you wish, you can choose to set an authentication token.
- Click save webhook.
What data is sent with a webhook?
Bookings
{
"event_type": "booking_created",
"event_data": {
"organisation": {
"id": "579..................57f",
"name": "Scott Hutcheson"
},
"booking": {
"id": "597..................963",
"start_time": "2017-07-26T11:30:00.000Z",
"end_time": "2017-07-26T12:30:00.000Z",
"price": 0,
"created": "2017-07-25T16:15:11.000Z",
"status": "Confirmed",
"type": "Hourly",
"timezone": "Europe/London",
"updated": "2017-07-25T16:15:11.000Z"
},
"participants": [{
"id": "597..................962",
"firstname": "Hannah",
"lastname": "Martin",
"timezone": "Europe/London",
"email": "hannah@email.com",
"spaces": 1,
"marketing_opt_in": true,
"booking_status": "No Status",
"notes": "These are some booking notes",
"questions": [
{
"label": "What is your shoe size?",
"value": "10"
},
{
"label": "Would you like a coffee?",
"value": "Yes"
}
],
}],
"bookables": [{
"id": "579..................5aa"
}],
"service": {
"id": "580..................5e0",
"name": "Meeting",
"type": "Hourly"
}
},
"event_timestamp": 1500999311
}Customers
{
"event_type": "customer_created",
"event_data": {
"organisation": {
"id": "579..................57f",
"name": "ACME Corp"
},
"customer": {
"id": "597..................962",
"firstname": "Hannah",
"lastname": "Martin",
"email": "hannah@email.com",
"marketing_opt_in": true
}
},
"event_timestamp": 1500999311,
}