Pingboard is real-time organizational chart software that makes it easy to build professional looking org charts. It keeps company org charts in sync with HRMS software automatically, thus replacing the manual need to make the org charts using flow charting applications like Microsoft Visio or Lucidchart. Pingboard was designed to help companies organize their employees and departments, develop hiring and succession plans, and share this information on the corporate org chart.

Supervisor configuration parameters

To configure the connector, following parameters are required:

• Connector name

• Client Id for the service account

• Client Secret for the service account

• Target URL (https://app.pingboard.com/api/v2)

• Instance DateTime Offset (refer Configuring additional datetime offset in connectors for more details).

Users

Table 350: Supported operations for Users

Operation	VERB
Create User	POST
Update User	PUT
Delete User	DELETE
Get User by Id	POST
List Users	POST

Groups

Table 351: Supported operations for Groups

Operation	VERB
Create Group	POST
Update Group	PUT
List Groups	POST
Get Group by Id	POST
Delete Group	DELETE

Mandatory fields

Users

• name.givenName

• name.familyName

• emails[].value

Groups

• displayName

• extension.groupType

User and Group mapping

The user and group mappings are listed in the tables below.

Table 352: Pingboard user to SCIM mapping

SCIM parameter	Pingboard parameter
id	id
userName	email
name.givenName	first_name
name.familyName	last_name
name.formatted	first_name + " " + last_name
displayName	first_name + " " + last_name
nickName	nickname
emails[].value	email
phoneNumbers[].value	office_phone
photos[].value	avatar_urls.original
timezone	time_zone
locale	locale
title	job_title
groups[].value (Only for read operation)	links.groups[] & links.locations[]
extension.description	bio
extension.manager.value	reports_to_id
meta.created	created_at
meta.lastModified	updated_at

 

Table 353: Pingboard group to SCIM group mapping

SCIM parameter	Pingboard parameter
id	id
displayName	name
members[].value	links.users[]
extension.description	description
extension.type	type
meta.created	created_at
meta.lastModified	updated_at

Connector limitations

• If all of the member IDs used in the create group request are invalid, an error with status 500 and no message will be returned but the group gets created. Even with at least one valid member ID, the group write operation gets successful.

• Even though the Pingboard API supports custom attributes for user resource, the Pingboard connector does not support custom attributes for users. The reason being is to avoid the unnecessary overhead in retrieving the names of the custom attributes by making additional request as the target API returns custom attribute IDs instead of the attribute name for GET user details response.

• An Admin user can also be deleted using APIs in which case the connector functionality will not work.

• Random string value for user's locale gets saved due to the target API behavior.