---
title: "How to setup a Freshbooks developer app"
img: https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_setup_a_freshbooks_developer_app-icon.png
date: 2025-10-03T00:00:00.000Z
tag: Guides
description: "This guide will show you how to retrieve your OAuth 2 credentials on Freshbooks"
url: "https://docs.unified.to/guides/how_to_setup_a_freshbooks_developer_app"
---

# How to setup a Freshbooks developer app
------
_October 3, 2025_

This guide will show you how to retrieve your OAuth 2 credentials on Freshbooks


## Create your Freshbooks App and get your Client ID and Secret

1. Go to the Freshbooks Developer Portal:
[https://my.freshbooks.com/#/developer](https://my.freshbooks.com/#/developer)
2. Click on `Create New App`

![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_setup_a_freshbooks_developer_app-0.png)

1. Fill in the Application Name, Application Type, these are mandatory
2. Add the scopes needed
    1. You can see the scopes we use on [https://app.unified.to/integrations/freshbooks?tab=oauth2](https://app.unified.to/integrations/freshbooks?tab=oauth2)
3. Add [`https://api.unified.to/oauth/code`](https://api.unified.to/oauth/code) in the Redirect URIs

![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_setup_a_freshbooks_developer_app-1.png)

1. You can also fill in the non mandatory fields, logo, etc.
2. Click Save
3. Click on the App again

![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_setup_a_freshbooks_developer_app-2.png)

1. Your Client ID and Secret are at the bottom

![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_setup_a_freshbooks_developer_app-3.png)


## Activate the Freshbooks Integration in Unified

1. Go to [https://app.unified.to/integrations/freshbooks?tab=auth](https://app.unified.to/integrations/freshbooks?tab=auth)
2. Click in `Your OAuth 2 credentials`
3. Add your Client ID and Secret
4. Click Activate

![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_setup_a_freshbooks_developer_app-4.png)