Connecting to Freckle from 3rd-party apps

Connecting other apps to Noko 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 Noko 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 Noko account, you'll probably see a connect to Noko button somewhere in the app.

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

  1. Follow the steps shown to you by the app to connect to your Noko account.
  2. Check that you are at secure.nokotime.com. You may need to sign in to your Noko account before you can allow the app to access your account. If you have access to multiple Noko accounts, Noko 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 Noko account.

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

You can always revoke access later by following these steps:

  1. In Noko, 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 Noko 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 Noko account any longer, it might still have data from your Noko 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 Noko account. Personal Access Tokens are keys you generate to allow an app to access your Noko 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 Noko.

To create a Personal Access Token, follow these steps:

  1. Click Integrations & Apps or Connected Apps in the green navigation sidebar
  2. Click the Noko 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 Noko account. These apps need two things in order to connect to your Noko account:

  • Your subdomain; the part of the URL right before .nokotime.com (For example, the subdomain for https://apitest.nokotime.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 Noko.

To get your API v1 Token, follow these steps:

  1. Click Integrations & Apps or Connected Apps in the green navigation sidebar
  2. Click the Noko 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