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 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 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 webhooks for either V1 or V2. You don’t need to install anything, just go to the homepage to create an endpoint and get going.


Whereas webhooks in API V1 can be selected directly in the interface, webhooks in V2 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.