Skip to main content
All CollectionsAdmin helpIntegrationsBeekeeper
Beekeeper Integration (User sync)
Beekeeper Integration (User sync)
Michael Azzopardi avatar
Written by Michael Azzopardi
Updated over 3 weeks ago

The Beekeeper Integration in Innform allows you to synchronize users (add/remove) between Beekeeper and Innform. With this integration, you can also use web hooks to automate actions when users are created, updated, or deleted in Beekeeper. Follow the steps below to connect your Beekeeper account and manage the sync process.

Prerequisites

Before you begin, ensure you have the following:

  • An Innform admin account with access to Account Settings.

  • Your Beekeeper API URL.

  • Your Beekeeper Bot Account Token.

Step 1: Accessing the Beekeeper Integration Settings

  1. Log in to Innform.

  2. Navigate to the side menu and select Account Settings.

  3. In the settings menu, click on Integrations.

  4. Locate and select the Beekeeper integration from the list.

Step 2: Connecting Your Beekeeper Account

  1. On the Beekeeper integration page, click the Connect Beekeeper Account button.

  2. A form will appear asking for your Beekeeper API URL and Bot Account Token.

    • Beekeeper API URL: Enter the URL provided by Beekeeper (https://<your_subdomain>.beekeeper.io/api/2/).

    • Bot Account Token: Input the token associated with your Beekeeper Bot Account.

  3. Once both fields are filled, click Connect Beekeeper Account to establish the connection.

Note: At this stage, the connection is successful but the users will not be synced automatically.

Step 3: Configuring Web Hook Options

After connecting your Beekeeper account, you can activate web hook options to automate the synchronization process. The available web hook events are:

  • USER.CREATED: Triggered whenever a new user is created in Beekeeper.

  • USER.UPDATED: Triggered when specific user fields are updated.

  • USER.DELETED: Triggered when a user is deleted.

To activate these options:

  1. On the same integration settings page, locate the Web Hook Options section.

  2. Toggle or select the web hook options you wish to activate based on your needs.

  3. Save your changes.

Step 4: Syncing Users and Groups

Once your Beekeeper account is connected and your web hook options are set up, you have full control over the initial sync process.

  1. Manual Sync:

    • To synchronize the users manually, click on the Sync Users button.

  2. Sync Users and Groups (if applicable):

    • If you are also using Beekeeper Groups, click on Sync Users and Groups to ensure that both users and their associated groups are synchronized.

Important: The initial connection does not automatically sync your user data. The synchronization is triggered only when you initiate the sync process manually.

Final Notes

  • Control: You have full control over when the sync occurs. This allows you to review the integration settings and data before the actual synchronization takes place.

  • Automation: With web hooks activated, your integration can automatically update Innform as changes occur in Beekeeper, ensuring your system remains up-to-date.

  • Troubleshooting: If you encounter any issues during the integration, double-check that the API URL and Bot Account Token are correctly entered. For further assistance, consult our support documentation or contact our help desk.

Did this answer your question?