Overview
Pingboard provides real-time, collaborative org chart software that makes it easy to organize and communicate with your teams. This article will give you an overview of the Pingboard/Grow integration.
NOTE: This data source is only available for accounts on the Basic and Professional plans. If you would like to upgrade your plan, talk to your Grow account manager or visit your account's billing page.
How to Connect
NOTE: If you want to connect your Pingboard account, your company must be on a Pro plan in order to have API access.
First, log in to Grow and select Add Metric. Choose Pingboard from the list of data sources, then click the blue Connect button.
The connection in Grow will ask for your Client Id and the Client Secret.
In Pingboard, an administrator will need to create a Service Account. In order to do this, go ahead and log in to your Pingboard account.
Click on the Add-Ons tab, then select the API subheading. On this page, go ahead and click on the green Manage Service Accounts button under Service Accounts.
On the next page, go ahead and click Add Service Account.
Give the new Service Account a name that will help you recognize it, such as Grow (or something similar). Turn on Company Admin, then save the account.
NOTE: Turning on the Company Admin means that the Service Account will have the same permissions as an Admin, which is necessary to access data on everyone in the company.
Copy the Client ID and the Client Secret from the next page and paste them into Grow.
Press Submit, and you are good to go!
If you need to access your Client ID and Client Secret later, just go back into your Pingboard account, then to Add-Ons, then API and finally Manage Service Accounts. You can select the same Service Account and view the Client Secret and ID again.
Endpoints
Below is a list of the endpoints offered through the Grow/Pingboard integration, along with a short description of the data each one returns.
- Users: All Pingboard users, including user ID, created date, roles, phone message channel, email message channel, start date, timezone, date of birth, locale, name, contact info, job title, reports to ID, department, employee type, skills, working groups, language proficiency, etc.
- Statuses: All created user status entries, including status ID, user ID, message, starts at, ends at, time period, all day (true/false), created date, updated date, type ID, created by ID, etc.
- Groups: All user sets defined by the organization’s admins, including group ID and name, description, created date, updated date, memberships count, type, visible to owner (true/false), visible to group (true/false), editable by owner (true/false), address, etc.
- Guests: All Pingboard visitor kiosk interaction entries, including guest ID, name, contact info, company name, country of origin, reason for visit, created date, and updated date.