How to register your own Sage 200 OAuth app

Register an OAuth app with Sage and connect it to Tenklo

This guide shows you how to obtain client credentials from Sage to use your own OAuth app with Sage 200. These are required to let your users grant your app access to their Sage 200 data.

Request client credentials

Submit the Sage 200 API credential request form to obtain your Client ID and Client Secret.

Set the redirect URI

When completing the credential request form, add the following Tenklo callback URL as an allowed redirect URI:

https://api.tenklo.dev/oauth/callback

Set the edition connection config

The edition field controls the API base URL and must be set by you (the developer) before your users connect — it is not shown in the end-user Connect UI.

Pass it when creating a connect session via POST /connect/sessions:

{
  "allowed_integrations": ["sage-200"],
  "integrations_config_defaults": {
    "sage-200": {
      "connection_config": {
        "edition": "sage200extra"
      }
    }
  }
}

Use "sage200extra" for Sage 200 Professional / Extra Online, or "sage200" for Sage 200 Standard Online.

For more details, see the Sage 200 authentication documentation.