Articles in this section

YouCanBook.me

Integromat Support Team Updated January 12, 2021 16:44

The YouCanBook.me modules enable you to monitor, retrieve, create, update, and delete profiles and bookings in your YouCanBook.me account.

Getting Started With YouCanBook.me

Prerequisites

A YouCanBook.me account — you can create one at app.youcanbook.me/#/register

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting YouCanBook.me to Integromat

To connect your YouCanBook.me account to Integromat, you need to enter your YouCanBook.me credentials in the Create a connection dialog in Integromat.

1. In Integromat, open the YouCanBook.me module's Create a connection dialog.

2021-01-04_12_02_51-Integration_YouCanBook.me___Integromat.png

2. Enter your YouCanBook.me email address and password, and click Continue.

If you have signed up using Google or Microsoft, you'll need to create a password. You can set your password in your account settings.

3. The connection has been established.

Profile

Watch Profiles

Retrieves profile details when a profile is created or updated.

Connection	Establish a connection to your YouCanBook.me account.
Watch Profiles	Select whether you want to watch new profiles (By Creation Time) or updated profiles (By Updated Time).
Limit	Set the maximum number of profiles Integromat will return during one execution cycle.

List Profiles

Retrieves all profiles in your YouCanBook.me account.

Connection	Establish a connection to your YouCanBook.me account.
Limit	Set the maximum number of profiles Integromat will return during one execution cycle.

Get a Profile

Retrieves profile details.

Connection	Establish a connection to your YouCanBook.me account.
Profile ID	Select or enter (map) the ID of the profile you want to retrieve details about.

Create a Profile

Creates a new profile (booking page).

Connection	Establish a connection to your YouCanBook.me account.
Title	Enter the name of the new profile.
Sub Domain	Enter the new subdomain for your YouCanBook.me profile.
Status	Select the status of the new booking page.
Description	Enter the description of the booking page.
Logo URL	Provide a URL of the logo to be used for the new booking page. PNG, JPEG, GIF, BMP accepted Max size 2000 x 2000 Max file size 2MB

Update a Profile

Updates an existing profile.

Connection	Establish a connection to your YouCanBook.me account.
Profile ID	Select or map the profile you want to update.
Title	Enter the name of the new profile.
Sub Domain	Enter the new subdomain for your YouCanBook.me profile.
Status	Select the status of the new booking page.
Description	Enter the description of the booking page.
Logo URL	Provide a URL of the logo to be used for the new booking page. PNG, JPEG, GIF, BMP accepted Max size 2000 x 2000 Max file size 2MB

Delete a Profile

Deletes a profile.

Connection	Establish a connection to your YouCanBook.me account.
Profile ID	Select or enter (map) the ID of the profile you want to delete.

Booking

Watch Bookings

Retrieves booking details when a booking is created, rescheduled, or canceled.

Connection	Establish a connection to your YouCanBook.me account.
Watch Bookings	Select whether you want to watch new booking profiles (By Creation Time), rescheduled bookings (By Reschedule Time), or canceled bookings (By Cancellation Time).
Profile ID	Select the profile you want to watch bookings for.
Search	Enter the term to filter returned results by.
Limit	Set the maximum number of bookings Integromat will return during one execution cycle.

List Bookings

Retrieves all bookings for the specified profile.

Connection	Establish a connection to your YouCanBook.me account.
Profile ID	Select the profile you want to list bookings for.
Search	Enter the term to filter returned results by.
Limit	Set the maximum number of bookings Integromat will return during one execution cycle.

Get a Booking

Retrieves booking details.

Connection	Establish a connection to your YouCanBook.me account.
Profile ID	Map or select the profile that contains the booking you want to retrieve details for.
Booking ID	Select or enter (map) the ID of the booking you want to retrieve details about.

Create a Booking

Creates a booking for the booking page (profile).

The Captcha Test must be turned off for the booking form to use this module. 2021-01-05_14_43_26-YouCanBook.me_-_Edit_booking_page.png

Connection	Establish a connection to your YouCanBook.me account.
Profile ID	Select the profile you want to create a booking for.
Title	Enter the title for the booking.
Receiver's Email	Enter the subscriber's email.
Starts at	Enter the start time of the booking. See the list of supported date and time formats.
Duration (Minutes)	Enter the duration of the booking.
Time Zone	Select the time zone of the booking.
Answers	Specify answers for booking questions. You can find shorthand codes in the web UI: Example of Answers:

Delete a Booking

Deletes a booking.

Connection	Establish a connection to your YouCanBook.me account.
Profile ID	Map or select the profile that contains the booking you want to delete.
Booking ID	Select or enter (map) the ID of the booking you want to delete.

Make an API Call

Allows you to perform a custom API call.

Connection	Establish a connection to your YouCanBook.me account.
URL	Enter a path relative to `https://api.youcanbook.me`. For example: `/v1/{username}/profiles`. For the list of available endpoints, refer to the YouCanBook.me API Documentation.
Method	Select the HTTP method you want to use: GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry.
Headers	Enter the desired request headers. You don't have to add authorization headers; we've already added those for you.
Query String	Enter the request query string.
Body	Enter the body content for your API call.

Example of Use - List Profiles

The following API call returns all profiles in your YouCanBook.me account:

URL:
/v1/{username}/profiles

Method:
GET

2021-01-05_16_11_06-Integration_YouCanBook.me___Integromat.png

The result can be found in the module's Output under Bundle > Body.
In our example, 4 profiles were returned:

2021-01-05_16_12_18-Integration_YouCanBook.me___Integromat.png

Was this article helpful?

0 out of 0 found this helpful