n8n guide

Connecting TallyPrime to this platform.

Before you start

An application, with its Client ID and Secret. See Applications & credentials.
A connected TallyPrime company, so there is something to authorize against.

The URLs to use

Authorization URL

http://localhost:4173/api/v1/oauth/authorize

Access token URL

http://localhost:4173/api/v1/oauth/token

Refresh token URL

http://localhost:4173/api/v1/oauth/token

Scopes

tally.read tally.write connection.read

Redirect URL to register on your application

https://your-n8n-host/rest/oauth2-credential/callback

Setting it up

1
Create an application in your dashboard and choose n8n as the platform.
2
Register the redirect URL above on that application.
3
In n8n, create a new connection with the Client ID, Secret and the three URLs.
4
Start the connection. You will be sent to our approval screen.
5
Choose which TallyPrime connection it may use, and approve.
6
The TallyPrime actions are now available in that platform's step picker.

What is handled for you

Behaviour	Detail
Credential type	Use an OAuth2 API credential with the Authorization Code grant. Put the Client ID and Secret in it, and the three URLs below.
Repeating rows	A fixedCollection field wraps rows in a named property, and a "multiple values" field sends parallel arrays. Both are unwrapped into rows automatically, so either node style works.
Self-hosted	Your redirect URL is your own n8n host. Add every environment you use — staging and production are different URLs and each must be registered.

Testing the connection

GET /api/v1/oauth/userinfo confirms the token and returns the connection and company names — a good label for the platform's connection list.

Which operations to expose

Build the step list from GET /api/v1/tally/operations — label, description, required fields, whether it writes. It stays current without a connector release.

Operation reference Error reference

This guide opens when n8n goes live

The official Balancely app for n8n is on its way. Until then, any tool that can make a web request can use the REST API.

Read the API overview

Something missing on this page? Tell us and we will fix it.

Need help?