Facebook Workplace is a collaborative business platform run by Facebook to help users communicate through groups, chat, and social networking in a corporate environment.

Supervisor configuration parameters

To configure the connector, following parameters are required:

• Connector Name

• API Key

• Target URL

• Graph API URL

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

Supported objects and operations

Users

Table 17: Supported operations and objects for Users

Operation	VERB
Create	POST
Update (Id)	PUT
Delete (Id)	DELETE
Get (Id)	GET
Get	GET
Pagination	GET

Groups

Table 18: Supported operations and objects for Groups

Operation	VERB
Create	POST
Update (Id)	PUT
Delete (Id)	DELETE
Get (Id)	GET
Get	GET
Pagination	GET

Mandatory fields

Users

• User Name

Groups

• Group Name

User and Group mapping

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

Table 19: User mapping

SCIM parameter	Facebook Workplace parameter
Id	Id
UserName	userName
Name.Formatted	name.formatted
Name.GivenName	name.givenName
Name.FamilyName	name.familyName
Name.MiddleName	name.middleName
Name.HonorificPrefix	name.honorificPrefix
Name.HonorificSuffix	name.honorificSuffix
DisplayName	displayName
NickName	nickName
UserType	userType
Title	title
PreferredLanguage	preferredLanguage
Locale	locale
Timezone	timezone
Active	active
Emails	emails
Addresses	addresses
PhoneNumbers	phoneNumbers
Groups.value	Group.id
Groups.display	Group.name
Extension.Organization	organization
Extension.Division	division
Extension.Department	department
Extension.Manager.Value	manager.managerId
Extension.EmployeeNumber	employeeNumber
Extension.CostCenter	costCenter
Meta.Created	Meta.created

 

Table 20: Group mapping

SCIM Parameter	Facebook Workplace parameter
Id	Id
DisplayName	Name
Members.value	UserOrGroupId
Meta.Created	CreatedDate
Meta.LastModified	LastModifiedDate
Extension.description	description
Extension.email	email
Extension.manager.value	owner.id
Extension.privacy	privacy

Connector limitations

• Only the trial subscriptions created using a business email ID with valid domain account will have the access to API integration. The subsequent subscriptions will not have the access.
• Create Groups, Update Groups and Delete Groups are not supported at the free subscription provided by target system.
• You can use a Group object only if at least one member associated with it.
• The Group will get deleted automatically when the last member is removed from the membership association.
• Connector supports Add Group Manager and Modify Group Manager, however the group details returned by connector will not have Group Manager information unless the group is created using the user interface of Facebook Workplace. This is due to the limitations of API provided by the target system.