![Page cover image](https://docs.nimbusintelligence.io/~gitbook/image?url=https%3A%2F%2F1735469989-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FKSboB0jIw43eWLIQyF8S%252Fuploads%252FWX1nN0cfgWpGqG8Yv2de%252FFreeAgent%2520banner.png%3Falt%3Dmedia%26token%3D3fcc0c24-f503-40c0-8937-edfdcb831aa3&width=1248&dpr=4&quality=100&sign=aeaf9069&sv=1)
FreeAgent
Accounting Software, Built for Small Businesses
About FreeAgent
FreeAgent is accounting software designed for small businesses, freelancers, and entrepreneurs. It offers a range of financial tools to simplify tasks such as invoicing, expense tracking, and tax management. With FreeAgent, users can easily create and send professional invoices, automatically import bank transactions, and monitor their financial health through customizable dashboards.
Get the Nimbus Intelligence Connector in Snowflake
You can install the Nimbus Intelligence FreeAgent Connector from the Snowflake Marketplace with only a few clicks!
Obtain Credentials and Create a Connection
This connector is based on OAuth 2.0 authentication. Follow the instructions to obtain your credentials and set up a Connection:
Log into the FreeAgent Developer dashboard.
Click on Create a new app.
Create a new app clicking on the Create a new app button.
Fill in the Name and Description for your application. There is no necessity of filling in more fields.
Click on Create App.
Store safely the following credentials that you will see
OAuth identifier -> This is the Client ID you will use in the Connector application
Secret -> This is App Secret you will use in the Connector application
Build the following URL with your own
CLIENT_ID
and paste it into a browser.https://api.freeagent.com/v2/approve_app?client_id=<YOUR_CLIENT_ID>&response_type=code&redirect_uri=https://developers.google.com/oauthplayground
A page where you will have to login will appear. Once logged in, click on Approve App.
A 404 Error page will appear. You will see a URL with this format
https://www.postman.com/oauth2/callback?code=<YOUR_CODE>&state=
. Extract<YOUR CODE>
from the URL and save it. This is an Authorization Code that will be exchanged for a Refresh token.Using an API query service (such as Postman) create a POST request to the
https://api.freeagent.com/v2/token_endpoint
URL with the following Parameters.Make sure int he Headers section the key-pair
Content-Type: application/json
is added as well.Once the request is sent, you will receive a JSON result like this
Copy the
refresh_token
from the result. This is the Refresh Token you will use in the Connector application.In the Connector application, head to the Connections page and fill in the Add connection form with the connection name that you want to create and the credentials you obtained in steps 6.1, 6.2 and 11.
Click on the
Generate Ready-to-Run
script and execute the provided pre-filled script in a new worksheet. This will generate a new connection for your FreeAgent Connector.
Available Endpoints
Check the full FreeAgent API documentation.
Endpoint | Incremental Ingestion | Incremental Fetching |
---|---|---|
Not supported by FreeAgent | Not supported by FreeAgent | |
Yes | Not supported by FreeAgent | |
Yes | Yes | |
Yes | Not supported by FreeAgent | |
Yes | Not supported by FreeAgent | |
Not supported by FreeAgent | Not supported by FreeAgent | |
Yes | Not supported by FreeAgent | |
Not supported by FreeAgent | Yes | |
Yes | Yes | |
Yes | Yes | |
Yes | Yes | |
Yes | Yes | |
Not supported by FreeAgent | Yes | |
Yes | Not supported by FreeAgent | |
Not supported by FreeAgent | Not supported by FreeAgent | |
Yes | Not supported by FreeAgent | |
Not supported by FreeAgent | Not supported by FreeAgent | |
Not supported by FreeAgent | Not supported by FreeAgent | |
Not supported by FreeAgent | Not supported by FreeAgent | |
Yes | Not supported by FreeAgent | |
Yes | Yes | |
Yes | Yes | |
Yes | Not supported by FreeAgent | |
Not supported by FreeAgent | Not supported by FreeAgent | |
Yes | Not supported by FreeAgent |
Need Help?
Don't forget to check the#faqs section in the Getting Started page.
Did we forget to implement an endpoint that you would like or did you find a bug? If you didn't find your answer in the FAQs, let us know!
If you have an issue, check the #known-limitations-and-issues section to see if we are already working on it!
Check the rest of the Available Connectors
Available ConnectorsLast updated