Making requests

Authentication and headers

You need a personal access token to access the API and to perform actions on your behalf. Your personal access token needs to be send trough an Authorization Bearer request. You can download your personal access token in Trengo.

Next, you are also required to send JSON headers for a proper request processing and a JSON response.

name	value
Endpoint	https://app.trengo.com/api/v2
Authorization	Bearer {{YOUR_TOKEN}}
Content-Type	application/json
Accept	application/json

API rate limiting

All requests to the Trengo API are rate limited to prevent abuse or possible high CPU / memory usage and this is something you need to take in account when implementing the API. The current rate limit is 120 requests per minute. The API responses contains useful rate limit headers to check the remaining requests.

name	description	example
x-ratelimit-limit	The rate limit	120
x-ratelimit-remaining	The remaining requests left for the current ratelimit window.	5

Note that when you hit the ratelimit a HTTP-status of 429 (Too Many Requests) is returned and a header "Retry-After" & "X-RateLimit-Reset" is send to the client. These values can be used to determine when the next call will be possible (Where "Retry-After" is the number of seconds to wait. This is the safest way as it does not matter if you have a clock-skew with the server.).

Please contact us in case you think the current rate limit is to strict for your use case.