When building an integration as a developer or an integrator, you can use a free trial account and contact our support team to help you convert your free trial account into a sandbox account. We wouldn't want your work to be lost because of an expired trial account. 


To test API calls for your API V2 integration, we recommend using Insomnia. Click the link to go to their homepage to download the tool. Once installed, take the following steps:


  1. Create a new request by clicking the arrow next to the plus sign and fill in the request you’ll find in the API V2 documentation. In our example, we’ll take ‘companies.list’


2.  Select ‘OAuth 2.0’ below the header ‘Auth’.


3. The screenshots below shows what value to fill in where:


4. If all goes well, a pop-up will appear and you’ll be asked to fill in your Teamleader Focus login details.


5. Your access tokens will then be made.

Access tokens: These expire 1 hour after they are issued for security reasons. If your integration needs to communicate with the API beyond the access token lifespan, you will need to request a new access token using the refresh token which was issued along with the access token. Note that refresh tokens can only be used once in order to get a new access token and refresh token.

Refresh tokens: will continue functioning until the user revokes them or uninstalls the integration, but Insomnia will take care of this for you.


6. Now it’s time to call up your Teamleader Focus API V2 endpoints.


7. If all goes well, you will see the results in JSON in the right-hand side of your screen.


Test API V2 webhooks

Use Beeceptor to test your Teamleader Focus webhooks. You don’t need to install anything, just go to the homepage to create an endpoint and get going.


Webhooks are registered via the API. To register, list or unregister Webhooks for API V2. Go to the API V2 documentation under ‘Other’.


Finally, use Beeceptor to check if the triggers come through correctly.