Custom Integration: FAQs

Officevibe allows you to create a customized integration between your HRIS (or any other consistent source) and your Officevibe account. This is an ideal solution if your organizational context requires you to have additional control and flexibility when managing your members and their segmentation. This solution is beneficial when mapping complex organizational structures.

This integration requires advanced technical knowledge that includes programming and software coding capabilities. The person in charge will need to be assigned as an administrator of the Officevibe account.


We have compiled the frequently asked questions below:


What data can I export from the API?

You can use the API to export your; Engagement Scores, Feedback Report, Team list, and Members. You cannot export the; Question results, Custom Survey Data, Goals, 1-on-1s, or Good Vibes — refer to our API Documentation for how to do this!


How do I ensure members are Invited when I sync?

You must ensure that "InviteNewUsers" is set to true in your Enterprise Sync Tool.


Can I test my custom integration without inviting any Members?

Yes — you must ensure that "InviteNewUsers" is set to false in your Enterprise Sync Tool. Members will be under the Created status and will not be invited until you invite them manually in the platform.


If I decide to set "InviteNewUsers" to FALSE, how do I invite my Members after?

Should I re-upload the file with "InviteNewUsers" set to true? You can invite your members via the platform! Re-uploading with "InviteNewUsers" to true will not work.

Once you are in your Members' settings, you first need to click on More filters (next to the dropdown) > select the Created status > click on the blue Apply button, and you will then be able to select Members.

If not, the option to choose Members will be greyed out.


Are Administrators/Executive Managers affected by the API Integration?

No — the API does not alter the status of Admins/Executive Managers. Their access must be managed directly in the platform.


Do Administrators need to be on the file?

No — Administrators do not need to be included in the file. If an Administrator is listed on your account but not in your files, they will not be deactivated.


Who inputs the information in the CSV files?

The designated Administrator will have to systematically export data from their HR system to ensure that the Integration is continually updated.

They can potentially run a script on their side which will regularly update the CSV/JSon files they are syncing with Officevibe. Otherwise, they will have to manually export from their HR system to update the files they are integrating with us.


Can we use special characters in the API files?

Special characters found in users' names will sync properly with Officevibe, i.e., including "ñ" and "í".


Can Officevibe help restore all the data we mistakenly wiped while concluding tests with the custom API?

Rest assured that we can work on a solution that will bring back most of the data that is no longer accessible.

To begin with, please note that we cannot proceed with a backup of deleted Team structures when they have been deleted via the API files.

A workaround we suggest is to recreate your organization's Team structures in your API files as they were before this event (recreate your Teams, Sub-Teams, add appropriate Members and Managers, etc.). Once this has been done, we may do a recompute on our side, which will recalculate/bring back the data associated with each member currently removed from the account.

Note, however, that while this operation can import current Members' data, it cannot account for any historical team mobility, so your recomputed reports may differ slightly from their original versions.

Unfortunately, if any members were permanently deleted, it will not be possible to restore their data - they will need to be re-invited and begin the process as new users. To prevent such losses, the Integration can only deactivate members, and deletions must be made manually in-app.


How do I change my Team names without losing data?

Not manually, as we understand it would be time-consuming. There is a workaround to change the team names via the API, which will basically require uploading a file with the current names. Hence, why each Team has a unique ID created for them, and then upload another file that would change the team names as desired without creating new Teams and losing your data.

To ensure that you keep the data, here is the best course of action:

  1. Sync with the API the first time but keep the previous team names. This sync would then add the correct external IDs to Teams. External IDs do not need to match pre-existing IDs at this step — we encourage you to use IDs from your own lists but avoid using the Team's name as the team ID. 
  2. Sync a second time with the new team names. The app would then find the teams using their external IDs and update their name.

E.g., let’s say “Team A” becomes “Team 1," and its ID in your account is “0001”. In Officevibe's database, we would have team A as its name and no external ID (since there has not yet been an API sync in the account). The first API file would have the mapping { “ID: “0001”, “name”: “Team A” }.

By syncing with the old name first, the application would find the correct Team in the database by name and add its external ID.

Then, we could sync again, but the file would look like { “ID: “0001”, “name”: “team 1” }.

During the second sync, the app would find the team by its external ID and update it, changing its name to Team 1.


I have an existing account with data and want to start using the Custom API for provisioning. Will I lose my data?

No. You must ensure that the team names in your API files match what you currently have in the platform when activating your Integration. If you want to change names, you can do so after the first sync because your Teams will have associated IDs.


Can I keep Teams in the platform but not include them in the API files?

The API will overwrite all Members and Teams, not in the files — that said, all Teams will be managed by the Integration.

Rule-Based Teams that are managed by segments will not be overridden.


Can I create properties and segments via Custom Integration?

The API can only assign property values based on what is already created in the platform. It can’t create properties or segments for you.

Find out how to create your properties and segments via this article: Segment Your Team Members.


Can I test my Integration before running it in my production account?

You can contact our Support Team to request a sandbox environment for testing at no additional charge. 


What do the Error messages mean?

Attribute Not Found:

To map a property to a user, the property must already exist. Also, note that properties' names are case-sensitive.

Skipped User Attribute Option Not Found

Property name and value are missing, meaning the option should be added manually via the platform in the properties settings before it can be used in syncs.

Skipped User Mapping To Group - Group Not Found

Both mean the same — the excel file displays the problematic group's ID in the "ExternalId" column. There is no such group in the groups.csv file. Therefore, when we try to match it with the values in the group-mappings.csv file, there is nothing to match. The solution would be to add the group and its name in the groups' CSV.

Skipped Subgroup Mapping To Group - Subgroup Not Found

Could not establish a connection to the API. Make sure the submitted API key is correct.

The integration is not able to connect at all. Either a new key has been generated, it has been turned off in-app, or a mistake was made in the configuration file.

You must activate API synchronization via the admin dashboard on

For the API to work, the account needs to have a Pro Subscription. It could also be that the key was generated, but the option wasn't turned on in-app.

Main: An error occurred while syncing

This error is usually followed by more detail and is usually related to one of the CSV files being invalid.