Custom Integration Creation in Workplace

Last published : Jun 07, 2026
Workplace from Facebook allows third parties to fetch data from its APIs for Compliance and eDiscovery purposes - this is achieved by using Custom Integrations.
Note: Custom Integrations are not available in free Workplace plans, so customers who need to meet Compliance and eDiscovery must have a Premium plan.
To create a custom integration:
  1. Login to workplace using a System Administrator account.
  2. Navigate to https://my.workplace.com/work/admin/apps/.
  3. Sign in if prompted to.
  4. Click Create Custom Integration.
  5. Enter a name for the Integration and click Create.
  6. Copy App ID and App Secret.
  7. Click Create Access Token and copy the generated token.
  8. If Discoverable is set to Yes, change it to No. This is not required but it is best practice to make sure the users are not aware of existence of the application.
  9. Under Integration Permissions, enable the following permissions:
    • Read group content
    • Read user timeline
    • Read all messages
    • Read user email
    • Read group membership
    • Message any member
      • Allow this integration to work in group chats
  10. To make sure the permissions remain available for the collector, disable Automatically remove unused permissions. This is not required; you can leave it on for better security, but you might need to come back to this page and re-add the permissions.
    Note: Facebook allows you to scope the App's permissions to specific groups. This is recommended if you only need to monitor users of the certain groups.
  11. Enable Require App Secret Proof and allow list the public IP addresses of your Arctera Insight Capture server(s), gateways and/or proxy server(s).
Related information