Active
This application does not need additional settings. So you can make connectionUnique, active service acces point to a network. There are different types of connections (API key, Oauth…). only by using your login credentials or by following the instructions below .

Redirect url

https://integrator.boost.space/oauth/cb/freeagent

FreeAgent

With FreeAgent modulesa module is an application or tool designed to handle specific business functions, such as CRM, project management, or inventory. The system's modular architecture allows you to activate only the modules you need, enabling customization and scalability as your business requirements evolve. in Boost.spaceA platform that centralizes and synchronizes company data from internal and external sources, offering a suite of modules and addons for project management, CRM, data visualization, and more. Has many features to optimize your workflow! IntegratorPart of the Boost.space system, where you can create your connections and automate your processes., you can manage the contacts, tasks, invoices, and monitor usersCan use the system on a limited basis based on the rights assigned by the admin. in your FreeAgent account.

To use the FreeAgent modules, you must have a FreeAgent account. You can create an account at freeagent.com.

Refer to the FreeAgent API documentation for a list of available endpoints.

Connect FreeAgent to Boost.space Integrator

To establish the connection, you must:

Log in to your Boost.space Integrator account, add a FreeAgent modulea module is an application or tool designed to handle specific business functions, such as CRM, project management, or inventory. The system's modular architecture allows you to activate only the modules you need, enabling customization and scalability as your business requirements evolve. to your scenarioA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive., and click Create a connection.
Optional: In the Connection name field, enter a name for the connection.
Optional: Click Show advanced settings and enter your custom appCreate your own custom apps to be used in the integrator engine and share them with users in your organization. client credentials. For more information, refer to FreeAgent OAuth 2.0 Guide.

If requested, use the following Redirect URI when creating your custom app: https://integrator.boost.space/oauth/cb/freeagent.
Click Save.
If prompted, authenticate your account and confirm access.

You have successfully established the connection. You can now edit your scenario and add more FreeAgent modules. If your connection requires reauthorization at any point, follow the connection renewal steps here.

Create a custom application in FreeAgent

To create an FreeAgent custom application and retrieve your client credentials:

Log in to your FreeAgent Developer account.
Click Create New App.

Enter the details provided as a reference in the below table.

Name	App’s name
Description	Details of the app.
App Homepage URL	App’s website URL address.
OAuth Redirect URI	Enter the following redirect URIs: `https://integrator.boost.space/oauth/cb/freeagent` `https://www.integrator.boost.space/oauth/cb/freeagent`
Icon	App’s profile image.
Enable Accountancy Practice API	Optional: Select the checkbox to enable the Accountancy practice API for the app.

Click Create App.
Copy the OAuth identifier and OAuth secret to a safe place.

You will use these values in the Client ID and Client Secret fields in Boost.space Integrator.

Contacts

You can watch, list, retrieve, create, update, and delete contacts using the following modules.

Watch Contacts

Watches for newly created contacts.

Connection	Establish a connection to your FreeAgent account.
Limit	Set the maximum number of contacts Boost.space Integrator will return during one execution cycleA cycle is the operation and commit/rollback phases of scenario execution. A scenario may have one or more cycles (one is the default).. The default value is 2.

List Contacts

Returns a list of contacts.

Connection	Establish a connection to your FreeAgent account.
Limit	Set the maximum number of contacts Boost.space Integrator will return during one execution cycle. The default value is 10.

For field descriptions, see the FreeAgent API reference.

Get a Contact

Returns a specified contact.

Connection	Establish a connection to your FreeAgent account.
Contact ID	Select or map the Contact ID whose details you want to retrieve.

Create a Contact

Creates a new contact.

Connection

Establish a connection to your FreeAgent account.

For field descriptions, see the FreeAgent API reference.

Update a Contact

Updates a specified contact.

Connection	Establish a connection to your FreeAgent account.
Contact ID	Select or map the Contact ID whose details you want to update.

For field descriptions, see the FreeAgent API reference.

Delete a Contact

Deletes a specified contact.

Connection	Establish a connection to your FreeAgent account.
Contact ID	Select or map the Contact ID you want to delete.

Tasks

You can watch, list, retrieve, create, update, and delete tasks using the following modules.

Watch Tasks

Watches for newly created tasks.

Connection	Establish a connection to your FreeAgent account.
Limit	Set the maximum number of tasks Boost.space Integrator will return during one execution cycle. The default value is 2.

List Tasks

Returns a list of tasks.

Connection	Establish a connection to your FreeAgent account.
Limit	Set the maximum number of tasks Boost.space Integrator will return during one execution cycle. The default value is 10.

For field descriptions, see the FreeAgent API reference.

Get a Task

Returns a specified task.

Connection	Establish a connection to your FreeAgent account.
Task ID	Select or map the Task ID whose details you want to retrieve.

Create a Task

Creates a new task.

Connection

Establish a connection to your FreeAgent account.

For field descriptions, see the FreeAgent API reference.

Update a Task

Updates a specified task.

Connection	Establish a connection to your FreeAgent account.
Task ID	Select or map the Task ID whose details you want to update.

For field descriptions, see the FreeAgent API reference.

Delete a Task

Deletes a specified task.

Connection	Establish a connection to your FreeAgent account.
Task ID	Select or map the Task ID you want to delete.

Users

You can watch users using the following module.

Watch Users

Watches for newly created users.

Connection	Establish a connection to your FreeAgent account.
Limit	Set the maximum number of users Boost.space Integrator will return during one execution cycle. The default value is 2.

Invoices

You can watch, retrieve, create, search, and delete invoices using the following modules.

Watch Invoices

Watches for newly created invoices

Connection	Establish a connection to your FreeAgent account.
Limit	Set the maximum number of invoices Boost.space Integrator will return during one execution cycle. The default value is 2.

Create an Invoice

Creates a new invoice.

Connection

Establish a connection to your FreeAgent account.

For field descriptions, see the FreeAgent API reference.

Get an Invoice

Returns a specified invoice.

Connection	Establish a connection to your FreeAgent account.
Invoice ID	Select or map the Invoice ID whose details you want to retrieve.

Search Invoices

Searches for invoices or lists them all.

Connection	Establish a connection to your FreeAgent account.
Limit	Set the maximum number of invoices Boost.space Integrator will return during one execution cycle. The default value is 10.

See FreeAgent Invoice API reference for entering the field values to search the invoices that match the specified value.

Delete an Invoice

Deletes a specified invoice.

Connection	Establish a connection to your FreeAgent account.
Invoice ID	Select or map the Invoice ID you want to delete.

Other

You can call APIs using the following module.

	Note
	For the list of available endpoints, refer to the FreeAgent API documentation.

Make an API Call

Performs an arbitrary authorized API call.

Connection	Establish a connection to your FreeAgent account.
URL	Enter a path relative to `https://api.freeagent.com.` For example, `/v2/users/me`
Method	GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry.
Headers	Enter the desired request headers. You don’t have to add authorization headers; we already did that for you.
Query String	Enter the request query string.
Body	Enter the body content for your API call.

Example of use – List Contacts

The following API call returns all the contacts from your FreeAgent account.

URL: /v2/contacts

Method: GET

Matches of the search can be found in the module’s Output under Bundle > Body > contacts.

In our example 5 contacts were returned: