Custom integrations on Workplace are services that use the Graph API and the Account Management API to extend the functionality of Workplace.
By building a custom integration app, you can keep employee information in sync with an identity service, automate group membership, make backups of posts in groups, or automate posting to specific groups based on activity in another service.
You can also use custom integrations to build group and chat bots that can communicate in groups on Workplace and in Work Chat.
Custom integrations are suitable for in-house development for your organization (or bespoke development for the sole use of a single Workplace customer). If you have a different purpose, e.g., offering a SaaS or PaaS integration to multiple Workplace customers, you should use Third Party Apps instead.
Access tokens generated for custom integrations are not linked to the user that generated the token. As a result, tokens are not expired nor rotated when users are removed or deactivated. Access tokens stay valid until they are rotated manually by a Workplace admin, or the custom integration is disabled.
The Graph API and Account Management API for Workplace are openly available APIs which can be called by any developer that knows how to call REST-based APIs. Access to these APIs is controlled by apps, with specific permissions and protected by access tokens.
Only System Administrators of a Workplace community can create apps and generate access tokens in that community.
When you create a custom integration, two objects are created:
A Custom Integration token is generated and shown to you when creating your custom integration, and this token can be used to read and write posts as your page.
To create an app for Workplace, follow the steps below:
To learn more about creating apps for Workplace, or to find out use cases for custom integrations, read the guides below.