Connecting to Freckle from 3rd-party apps

Connecting other apps to Freckle is a great way to help you save time (and money!) by getting things done quicker. Depending on the app you're connecting to, you may be asked for one of the following:

  • If it's okay for the application to connect to your Freckle account
  • A Personal Access Token
  • Your API Token and Subdomain

Allowing an app to access your account

When an app wants to connect to your Freckle account, you'll probably see a connect to Freckle button somewhere in the app.

To allow an app to access your Freckle account, follow these steps:

  1. Follow the steps shown to you by the app to connect to your Freckle account.
  2. Check that you are at secure.letsfreckle.com. You may need to sign in to your Freckle account before you can allow the app to access your account. If you have access to multiple Freckle accounts, Freckle might also ask you which account you want to sign in to.
  3. Review the app's details in the approval dialog.
  4. Click the Yes, allow access button to allow the app to access your Freckle account.

Once that is done, the app is connected to Freckle. Follow the steps shown to you but the app! 

You can always revoke access later by following these steps:

  1. In Freckle, click on Integrations & Apps or Connected Apps in the green navigation sidebar
  2. Click the Connected Apps tab
  3. Find the application you want to disallow access to your Freckle account and click Settings…
  4. Click Revoke Access
  5. In the alert that shows up, confirm that you want to revoke access

Keep in mind that while the other application can't access your Freckle account any longer, it might still have data from your Freckle account stored from when it could still access it.  If you need to remove this data, consult the other application's documentation.

Creating a Personal Access Token

Some apps (like internal tools) use Personal Access Tokens to access your Freckle account. Personal Access Tokens are keys you generate to allow an app to access your Freckle account. You can destroy a Personal Access Token at any time and not affect any of your other connected apps.

Important: Personal Access Tokens are like passwords, so treat them like one—don't share them with anyone! Only use them in other apps to provide access to Freckle.

To create a Personal Access Token, follow these steps:

  1. Click Integrations & Apps or Connected Apps in the green navigation sidebar
  2. Click the Freckle API tab
  3. Look for Personal Access Tokens and click Settings…
  4. Use the Application Name field to label your new Personal Access Token
  5. Click the create token button to create the Personal Access Token
  6. Copy and paste the Personal Access Token into the app

Getting your API Token and Subdomain

Some apps use our older "API v1" way to access your Freckle account. These apps need two things in order to connect to your Freckle account:

  • Your subdomain; the part of the URL right before .letsfreckle.com (For example, the subdomain for https://apitest.letsfreckle.com would be apitest.)
  • Your API Token

Important: Your API token is like a password, so treat it like one—don't share it with anyone! Only use it in other apps to provide access to Freckle.

To get your API v1 Token, follow these steps:

  1. Click Integrations & Apps or Connected Apps in the green navigation sidebar
  2. Click the Freckle API tab
  3. Look for API v1 Token and click Settings…
  4. Click on click to reveal to show your token
  5. Copy and paste the token into the app