Skip to main content

Requirements

Registering Applications​

Applications that want to use the API need to be registered in the partner panel on BookingSync.com.

If you are not a partner yet, it's free to signup so join us :)

  • Click on New Application button.
  • Fill in required details, redirect_uri being your apps OAuth callback URL and admin_url to your admin section.
  • Choose if application should open in a new window (standalone), or remain embedded in BookingSync frame.
  • Choose Private application, at least during your development and testing process.

Note: BookingSync traditional Users have to input private access code in their Apps section to start using your private application. That code is automatically generated for you and is visible in your applications manage section.

Applications types​

Embedded​

Embedded applications are rendered within an iframe on BookingSync.com. You application needs to allow on embedding in iframe.

Standalone​

Standalone applications will be working outside of BookingSync website. It means that they will be opened in a new window outside of the BookingSync app.

While it's not the recommended approach, some applications can benefit from this.

Published Applications​

  • All published applications are available by default for all accounts.

Note: When first accessing the application, you will be asked to authorize the permissions.

Private Applications​

  • First obtain private access code from the application owner.
  • Input the code in your Apps section.

Note: When first accessing the application, you will be asked to authorize the permissions. After the first authorization, you will be able to keep access to their account until they manually request to revoke your access.

Connected Accounts Limit​

Private applications are limited to 5 connected accounts by default. Once an application reaches its limit, new installations are blocked — this applies to both the OAuth authorization flow and to installing the application using a private access code. Published and reviewed applications are not subject to this limit.

If you are the application owner and want to lift the cap, reach out to partners@smily.com to formalize the partnership (typically via a revenue share agreement). The limit is configurable per application and is lifted once the agreement is in place.

If you are a property manager and an installation is blocked, the application provider has reached the maximum number of accounts allowed under their current Smily partnership. Ask the provider to upgrade their partnership with Smily to unlock more installations.