Passing data to other systems

There are a few different ways to send data from YouCanBook.me to other platforms. 

Using Zapier

Zapier is a third party tool that allows you to connect over 1,000 apps. This means you can easily transfer data from YouCanBook.me through to your CRM or email service provider. Check out our article here on integrating Zapier to your YouCanBook.me account.

Using Outgoing Webhooks

Webhooks are a convenient way to pass data from one application to another with minimal programming ability. Similar to the use of an API, webhooks have a protocol to either retrieve information, send information or delete it from a server.

Webhooks will fire off after a specific event has occurred i.e. a booking is made, rescheduled, or cancelled.

💡Check out Zapier's post explaining webhooks.

There are three things needed for a webhook to work properly:

1. An endpoint URL
This is where you will be sending the data.

2. The request type
GET, PUT, POST, PATCH, DELETE
This tells the webhook what to do with the information.

3. Request Headers
Add a key value pair for any targer server to authorize the connection (advanced)

4. The payload
This is the information that you will be passing through.

You will be able to fill in any  shorthand code you have available to pull in information from the booking and pass it through your webhook.

The basic formatting will look like (in JSON):

{

 "startDateTime": "{START-ISO}",

 "endDateTime": "{END-ISO}",

 "firstName": "{FNAME}",

 "email": "{EMAIL}"

}

The formatting for this is important to ensure that accurate information is delivered. You will be able to pass through any information that is collected and you have a shorthand code to reference (even custom ones you create).

The endpoint URL is something that will be provided by the application or service you are passing this information into. Many companies will have documentation on how to use webhooks through their platforms, including the correct parameters you need to specify in the first " " set.

Encoding webhooks for special characters

Use encoding tags to preserve special characters passed through webhooks.

There are two tags to encode special characters, one for the webhook's URL and one for the webhook's payload.

• {ENCODE-FOR-URL}
• {ENCODE-FOR-JSON}

These tags will allow special characters to appear correctly when passed through webhooks.

Setting up a webhook

Selecting the booking page you want to add a webhook, and click Edit Settings.

1. Select Notifications from the left menu.
2. Click Actions under the sub-menu.
3. Click into the step you wish to have the webhook fire (Confirmation, Reschedule, Cancellation, Reminder)
4. Click the + to add a new notification
5. Click Webhook
6. Enter URL
7. Choose method
   1. GET - retrieves information about a resource.
   2. PUT - Creates a new resource
   3. POST - Changes an existing resource
   4. PATCH - Repairs a resource
   5. DELETE - deletes a resource
8. Add payload
9. Save changes

Validate your JSON formatting

Webhooks must be entered in a valid JSON format. If you see an error, you can use this site to make sure your JSON is formatted correctly.

Send data to Zapier through Webhooks

Video overview:

YouCanBook.me API

API connections require a bit more programming to work correctly. Similar to a webhook you will use the same methods to send data from YouCanBook.me into other platforms and applications. The biggest difference between API and webhooks is that API will require authentication (typically an API key) to connect correctly. Also there will be specific URL destinations for making changes. 

Accessing your account API key

Public API documentation

The YouCanBook.me Support Team can help with basic API questions, but isn't trained at in-depth API troubleshooting. You may need to hire a developer to help you configure something using the API. If you're a developer who wants to build your own integration with YCBM, check out our API documentation.