Introducing agent-level OAuth for Platform v3.1

Happening Announcements
, , , ,
1

Dear Developers,

With FDK v10.1.8, Platform v3.1 supports agent-level OAuth. This gives individual agents a way to authorize an OAuth connection for the app when that fits the app’s workflow. Account-level OAuth remains supported.

How it works

  • In oauth_config.json, set token_type to agent for one OAuth configuration.
  • Agent users authorize the app through an AUTHORIZE button in the app’s front end.
  • When reauthorization is needed, apps can use client.interface.trigger('reAuthorize').

Important considerations

  • You can configure agent-level authorization for only one OAuth configuration.
  • Multi-account authorization remains available only for account-level OAuth.
  • Agent-level OAuth cannot be used from server.js, in serverless apps, or in apps that run in the background.

Get started

Build with Platform v3.1 and FDK v10.1.8, then update one OAuth configuration with token_type set to agent. For configuration details and authorization guidance, see the OAuth implementation documentation.

To explore the OAuth implementation pattern, see the Freshworks OAuth sample app.

Note: Existing account-level OAuth remains supported.