How to register your own TIMOCOM OAuth app

This guide shows you how to obtain your OAuth credentials (Client ID & Client Secret) from TIMOCOM. These are required to let your users grant your app access to their TIMOCOM account.

Each TIMOCOM client can only use a single grant type, decided when TIMOCOM registers it. Tenklo uses the authorization code grant, so request a client registered for that grant type.

Request test client credentials

Contact TIMOCOM to request API access. In your request:

Name your organization and the APIs you need, for example the Profile API.
Ask for an OAuth client using the authorization code grant type.
Give https://api.tenklo.dev/oauth/callback as the redirect URI.
Ask for a test user.

TIMOCOM sends you test client credentials (Client ID and Client Secret).

Add your credentials to Tenklo

In Tenklo, open your TIMOCOM integration's Settings tab, enter your Client ID and Client Secret, and add the scopes your app needs, for example profile:company:read.

Only request scopes for the products you intend to use. TIMOCOM's launch checklist notes that requesting access to unwanted products causes unnecessary billing events.

Get business approval for production

Before production access is activated, TIMOCOM's Product or Partner Management team reviews your integration. Once approved, TIMOCOM provides your production client credentials. Replace the test credentials in Tenklo with them.

Items created in the test environment can't be migrated to production. See TIMOCOM's Launch checklist and Business approval requirements.

Follow the Quickstart to connect your first account. The users who connect must be TIMOCOM customers with access to TIMOCOM.

For more details, see TIMOCOM's OAuth2 documentation.