Skip to main content

BookingSync (Smily)

How to authenticate the integration​

We'll use a test app, Acme AI, to show how an end-user can authenticate the integration between BookingSync and Acme AI.

  1. Open your BookingSync Account and navigate to 'Apps > Private Apps'.

  2. Get the Private App Access Code from Acme AI’s team and paste it as below. Click on 'Add Private App'.

    bookingsync auth 1

  3. Acme AI will now be visible in your 'Private Apps' section like below.

    bookingsync auth 2

  4. Now, switch over to Acme AI's integration page and click on BookingSync's logo. You will now be redirected to an Authentication screen (as below) where you will have to allow Acme AI to access information from BookingSync.

    bookingsync auth 3

    bookingsync auth 4

How to setup OAuth app and Real-time webhooks​

Creating OAuth app in BookingSync:

  1. Navigate to the BookingSync Developer Partner Page and sign up to create an OAuth app.
  2. After logging in, select '+ New Application'. Provide the application's Name and Admin URL.
  3. Set the Redirect URL to https://dev.calry.app/api/v1/oauth/callback
  4. Set Embedded to True, and Published to False.
  5. Go to the Features tab, enable all synchronization options.
  6. Under the Marketing tab, input your Summary, Description, and upload your Logo. These details will be visible for the end-user during the authentication flow.
  7. Click 'Create Application'.
  8. Go to that application by selecting Manage.
  9. Navigate to the Webhooks tab within your application settings and click on 'New Webhook'. Enter the URL: https://dev.calry.app/api/v1/listener/workspace/bookingsync/{calryWorkspaceID}.
  10. Select the appropriate webhook events for your app and Confirm by clicking on 'Create webhook':
    • booking_created
    • booking_updated
    • booking_destroyed
    • inbox_conversation_created
    • inbox_conversation_updated
  11. Save the ClientID, ClientSecret, and Private App Access Code. These credentials will be required in subsequent steps.

Creating OAuth app in Calry:

  1. Visit https://dev.calry.app/workspaces/{calryWorkspaceID}/o_auth to create your OAuth app in Calry.

  2. Click on "+ New OAuth App" and select 'BookingSync' as the integration type.

  3. Enter a name for the integration and provide the ClientID and ClientSecret from Step 11 above.

  4. Enter the scope as follows: applications_read bookings_write_owned bookings_read bookings_write clients_read clients_write inbox_read inbox_write inquiries_write_owned inquiries_read inquiries_write payments_write_owned payments_read payments_write preferences_general_settings_read preferences_general_settings_write preferences_payments_read preferences_payments_write rates_read rates_write rentals_read rentals_write reviews_read reviews_write webhooks_read webhooks_write webhooks_write_owned

    Please make sure you don't change the syntax of the scope above. Copy and Paste it as it is.

  5. Finally click 'Create'.

Note: Change the base urls to prod.calry.app if you're connecting it to Calry production environment.

If you need help in creating OAuth app for BookingSync, don't hesitate to reach out at mail@calry.app