Access keys

How to get your API credentials to authenticate with the Tolq API

Generate your credentials

  1. Log into your Tolq account and navigate to the Integrations section

  2. Click "Generate Key" to create your API credentials.


    484
  3. Save your credentials securely - you'll need both the Access Key and Access Secret for all API calls.


623

Important Security Notes

  • Keep your credentials secure - treat them like passwords
  • Don't share them publicly or commit them to version control
  • Regenerate if compromised - you can create new credentials anytime (see Recovering the keys below)

Using the API

You're now ready to make API requests. For production use, ensure your payment details are configured in your account settings.

Technical Overview

The Tolq API is a REST-based API that:

  • Communicates via JSON - all requests and responses use JSON format
  • Uses HTTP Basic Authentication over secure HTTPS connections
  • Requires proper headers - set Content-Type: application/json for all requests

Authentication Setup

Use your Access Key and Access Secret as HTTP Basic auth credentials:

  • Username: Your Access Key
  • Password: Your Access Secret

Testing Your Setup

Using Postman:

  1. Set Authorization to "Basic Auth"
  2. Enter your Access Key as username
  3. Enter your Access Secret as password
  4. Set Content-Type header to application/json

Using curl:

curl -X POST https://api.tolq.com/v1/... \
  -u "your-access-key:your-access-secret" \
  -H "Content-Type: application/json"

Recovering the keys

You will have access to your access key from your account's Integration section. Due to security reasons the secret is not recoverable.

You can also regenerate your secret and access key in your account Integration section, by clicking on "regenerate key"

469

Next steps

Once you have your credentials, you're ready to make your first API call. Use these credentials in the authorization header of all requests.