Skip to main content

Integration broker

The Groove integration broker is a Groove-operated (or self-hosted) companion service that provides:

  • OAuth token exchange for integrations such as Google Sheets
  • App template gallery JSON for starter apps
  • Compatibility endpoints expected by the builder without calling Appsmith Cloud

Local Docker​

The local compose stack starts the broker on http://localhost:8090 and sets:

APPSMITH_CLOUD_SERVICES_BASE_URL=http://integration-broker:8090

(or the GROOVE_* equivalent in your compose file).

ServiceURL
Groove Builderhttp://localhost:8080
Integration brokerhttp://localhost:8090

Local SaaS OAuth can run in mock mode so Google credentials are not required for development.

Production​

  1. Deploy the broker from services/integration-broker/.
  2. Set Groove Builder’s cloud-services base URL to that broker.
  3. Configure real OAuth client credentials for Google Sheets (and any other broker-backed providers) in the broker, not against Appsmith Cloud.