The steps in this article, cater to the following audiences:

  • Businesses that are new to Zenoti and want to utilize its API functionality.

  • Existing businesses that need to generate new API Keys for apps other than the Default app.

Important: The process to generate and update an API key has changed.

  • Earlier navigation: At the organization-level, Admin > Setup > API

  • New navigation: At the organization-level, Admin > Setup > Apps.

Note: Generate a new API key for each individual app. For example, if you have a Web Booking app and a Mobile Booking app, you must generate two API keys respectively.

To generate a new API key

  1. At the organization-level, navigate to Admin > Setup > Apps.

  2. Click Add on the Manage Applications page.

  3. Enter the following information:

    1. Name: Enter the name of the application.

    2. URI: Enter the URL of your Website or the application. In case of errors or issues in the app, URI information is used to contact the app developer.

    3. Description: Enter a brief description of the app for which you are generating the API key.

    4. Login User Type: Select any one of the following

      1. Guest: Select this check box if this is a guest-facing application and the login user is a guest.

      2. Employee: Select this check box if this is an internal app and the login user is an employee of your business.

    5. Source App: Select one of the following from the drop-down list:

      1. External CMA: Select this option if the API is for the CMA. All the appointments booked from this application will be marked with the Mobile Booking icon.

      2. External Webstore: Select this option if the API is for Webstore. All the appointments booked from Webstore, will be marked with the Web Booking icon


      3. Client App: Select this option if the API is for client app of your business.

      4. Bot: Select this option if the API is for a bot. All the appointments booked by the bot will be marked with the Bot Booking icon.

    6. Post Logout Redirect URL: To redirect your users to a URL after they logout, click Add, and the enter the URL.

    7. Post Login Redirect URL: To redirect your users to a URL after they login, click Add, and enter the URL.

  4. Click Next.

  5. Manage the scope of your app by selecting the checkbox of data permissions under the appropriate API groups. For example, if you want to restrict access of the app only to an employee module, then expand and select only the corresponding employee permissions under the relevant API group. Choose your authentication method - either API keys (APIKEY GROUPS) or access tokens (JWT GROUPS) to authorize the app users.

  6. Click Next.
    The Credentials page appears.


    Zenoti generates a new Application ID and Secrets (secret key). These are used to generate a new API key.

  7. Copy the Application ID and the Secrets on a notepad.
    Note: Make a note of the Application ID and the Secrets before you navigate away from this screen. If you navigate away from this page, you must restart the API generation process from the beginning.

  8. Click Generate API Key.
    Zenoti generates a new API Key for your business and the app.

  9. Copy the API key on a notepad.

  10. Click Finish.

    Note: This API Key will work only for the designated app. If you have multiple apps, you must generate separate API Keys for each app. Repeat this process from Step 1 for each app. Zenoti recommends that you create separate apps for each of your use cases. It is difficult to audit logs and troubleshoot issues if there are multiple users of the same app. Many users of a single app with a single API key also pose security concerns.

See Also


Did this answer your question?