{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"FreshBooks integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"freshbooks-integration","__idx":0},"children":["FreshBooks integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["FreshBooks is cloud-based accounting software designed for small businesses and freelancers. The integration connects your FreshBooks account to Frontegg Agen for Work, enabling AI agents to manage clients, invoices, expenses, payments, projects, and time entries on your behalf."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A FreshBooks account with access to the Developer portal at ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://my.freshbooks.com/#/developer"},"children":["my.freshbooks.com/#/developer"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-freshbooks","__idx":1},"children":["Connect FreshBooks"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-open-the-freshbooks-developer-portal","__idx":2},"children":["Step 1: Open the FreshBooks developer portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://my.freshbooks.com/#/developer"},"children":["my.freshbooks.com/#/developer"]}," and sign in. You will land on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apps"]}," page. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create New App"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/freshbooks-1.221cdae06b0f6898fdea0671484264b01a764da674aabac10a7ebe0af8597be5.1ce25488.png","alt":"FreshBooks developer portal Apps page"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-fill-in-the-application-details","__idx":3},"children":["Step 2: Fill in the application details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Application"]}," dialog that appears, enter the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application Name"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Integration"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application Type"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Private App"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Website URL"]}," — your application URL (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://your-app.com"]},")"]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/freshbooks-2.875e8b3f55ec1a02a0dc7ed764efc79efd0c87bb486afa2ba8739f1bccea6a5d.1ce25488.png","alt":"FreshBooks Create Application form"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-configure-oauth-scopes","__idx":4},"children":["Step 3: Configure OAuth scopes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scroll to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scopes"]}," section and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Scope"]},". Add each of the following scopes:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:profile:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read user profile information"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:clients:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read clients"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:clients:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update clients"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:invoices:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read invoices"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:invoices:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update invoices"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:expenses:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read expenses"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:expenses:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create expenses"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:payments:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read payments"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:payments:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Record payments"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:projects:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read projects"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:projects:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update projects"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:time_entries:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read time entries"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:time_entries:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create time entries"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:account:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read account information"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:teams:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read team members"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:teams:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manage team members"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user:reports:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read financial reports"]}]}]}]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/freshbooks-3.0aaafb2f6f11007ad01a8100b30f1d2b60e8aea38d5aa6323f46000bf55d9099.1ce25488.png","alt":"FreshBooks OAuth scopes"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-configure-the-redirect-url","__idx":5},"children":["Step 4: Configure the redirect URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URIs"]}," section, enter your Frontegg Redirect URL and click the confirm button:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/freshbooks-4.8978cc5cae844d5fa589f7b6930f43255d8d2857861bef4661fea8064f449826.1ce25488.png","alt":"FreshBooks redirect URI and remaining scopes"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-save-and-copy-credentials","__idx":6},"children":["Step 5: Save and copy credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," to create the application. Then click on your app in the list to open its settings page. Scroll down to find the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," fields."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy both values — you will need them in the next step."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/freshbooks-5.11cdae46e3f9a12ac0b3b256612266ea1ee69d7935713a15e1934c0330e7ed8c.1ce25488.png","alt":"FreshBooks Client ID and Client Secret"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":7},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have obtained your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," from the steps above, enter them in the integration configuration page of the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to your environment → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["FreshBooks"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," in the corresponding fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the required ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scopes"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your Client Secret to version control."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":8},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.freshbooks.com/api/start"},"children":["FreshBooks API documentation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://my.freshbooks.com/#/developer"},"children":["FreshBooks developer portal"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]},"headings":[{"value":"FreshBooks integration","id":"freshbooks-integration","depth":2},{"value":"Connect FreshBooks","id":"connect-freshbooks","depth":3},{"value":"Step 1: Open the FreshBooks developer portal","id":"step-1-open-the-freshbooks-developer-portal","depth":4},{"value":"Step 2: Fill in the application details","id":"step-2-fill-in-the-application-details","depth":4},{"value":"Step 3: Configure OAuth scopes","id":"step-3-configure-oauth-scopes","depth":4},{"value":"Step 4: Configure the redirect URL","id":"step-4-configure-the-redirect-url","depth":4},{"value":"Step 5: Save and copy credentials","id":"step-5-save-and-copy-credentials","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"seo":{"title":"FreshBooks integration"}},"lastModified":"2026-05-01T18:45:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/freshbooks","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}