REST API > How do I access Tallyfy's open REST API?
We have an open REST API you can explore and integrate with at https://go.tallyfy.com/api/.
API access is available using your token, inside Tallyfy - within Settings >
If you're on the PRO plan, you'll need your
access_token to use our APIs.
There are two ways of obtaining the
access_token, depending on the use-case:
- Personal usage > From inside Tallyfy:
After logging in, navigate to
View Your API Access Tokento get the
- Client Apps or Dedicated Integrations > Use
Client Secretdetails supplied by us.
Please contact the Tallyfy Support team to get the Client ID and Client Secret. You'll need to provide the following details to us:
- Company name and website
- Tallyfy organization ID
- Your full name and role at the company
- Official work email address (not a personal gmail/outlook email address)
- Your telephone number (so we can contact you if we have any critical updates about the API)
After the above details are verified by us, we will send
Client Secretto the official work email address provided.
Once you have the Client ID and Client Secret details with you, you can obtain the
access_tokenby making a call to
/oauth/tokenwith your Client ID, Client Secret, Grant type, Required Scopes, Username, and Password. You'll receive the
access_tokenin the response - which you'll need to copy / save for future use.
You can try out our API interactively here but we strongly recommend you use a proper REST API client like Postman, etc. The video below demonstrates how to obtain the
access_tokenusing Client ID and Client Secret
Once you have the
access_token- this video demonstrates how to use it to make API calls:
A note about date formatting in our API
The Tallyfy API receives this date and timestamp format on requests:
In terms of responses, the API responds with this date and timestamp format:
Please note - You can emit step-level or process-level webhooks from Tallyfy without having to use the API.
Our API is published via the Swagger format for standardized consumption by service discovery agents.
If you would like help with integrations and setting up advanced features, please contact Tallyfy Support to learn more about additional services.