Skip to main content

Authentication and credentials

Initial setup: create the account in Koncili, create the application in Tiny and connect both ends via OAuth. Done once per customer.

Step 1

Create the Tiny ERP account in Koncili

In Koncili, go to Integrations and choose ERP > Tiny. Click Create new account.

On the creation screen, copy the redirect URL shown in the form. This link will be used when registering the application in Tiny.

Tiny ERP screen in Koncili with redirect URL and Copy button
Tiny ERP account creation screen in Koncili — copy the redirect URL.
Step 2

Create the application inside Tiny

In Tiny, go to Settings > General preferences > Other settings > Applications and click + new application.

olistERP
Alterar dados do usuário
Cadastro de usuários do sistema
Configurações do servidor de e-mail
Configurações das etiquetas
Configurações da agenda
Outras configurações
Interface do usuário
Central de notificações
Aplicativos
Token API
Configurações de API
Illustration based on the submitted screenshot — Tiny > Settings > General preferences > Other settings > Applications.

Set a name for the app (e.g. Koncili) and paste the URL copied in step 1 into the redirect field.

On save, Tiny generates the Client ID and the Client Secret. Copy both values to use in Koncili.

Enable the required permissions, at least Accounts Receivable.

Tiny API Applications screen with + new application button
Tiny > Settings > Applications — click "+ new application".
Tiny screen with generated Client ID and Client Secret
Client ID and Client Secret generated by Tiny after saving the application.
Application permission list including Accounts Receivable
Enable the application permissions — include at least "Accounts Receivable".
Step 3

Connect the account in Koncili

Go back to the account creation screen in Koncili. Fill in the account name, Client ID and Client Secret.

Click Connect with Tiny to open the OAuth authorization and, after completing authentication, click Save.

Koncili screen with Client ID and Client Secret filled in and Connect with Tiny button
Paste Client ID/Secret, name the account and click "Connect with Tiny".
Tiny ERP account connected in Koncili
Account saved and connected — it now appears in Koncili's Tiny ERP integration.
Expiration: if the authorization stays unused for 30 days, access expires. In that case, reconnect the account by repeating step 3.