Skip to main content

​
API Keys

Create and manage API keys for integrating Tiquo with your systems.

​
Overview

API keys enable:
  • Programmatic access to Tiquo
  • Custom integrations
  • Automated workflows
  • Third-party connections

​
Creating API Keys

1

Navigate to API Keys

Go to Settings → API Keys
2

Click Create Key

Click Create API Key
3

Name Your Key

Give it a descriptive name
4

Select Scopes

Choose allowed permissions
5

Generate

Click Create
6

Copy Key

Copy immediately (shown once)
Copy your API key immediately. It won’t be shown again.

​
API Key Scopes

​
Available Scopes

ScopeAccess
customers:readRead customer data
customers:writeCreate/update customers
orders:readRead order data
orders:writeCreate/manage orders
services:readRead service catalog
analytics:readAccess reports
settings:readRead settings
settings:writeModify settings

​
Scope Selection

Choose minimum necessary:
  • Read-only for reporting
  • Write for creating records
  • Full for admin tasks

​
Managing Keys

​
Viewing Keys

See all active keys:
  • Key name
  • Last used
  • Created date
  • Scopes

​
Revoking Keys

Remove access:
  1. Find the key
  2. Click Revoke
  3. Confirm revocation
Revoked keys stop working immediately.

​
Rotating Keys

Best practice is regular rotation:
  1. Create new key
  2. Update your systems
  3. Revoke old key

​
Security Best Practices

Only grant permissions that are needed.
Store keys in environment variables, not code.
Rotate keys every 90 days or after team changes.
Review API usage logs for anomalies.

​
Rate Limits

​
Limits by Plan

PlanRate Limit
Starter100 req/min
Pro1,000 req/min
Enterprise10,000 req/min

​
Handling Limits

When rate limited:
  • Receive 429 response
  • Wait and retry
  • Implement backoff

​
Using API Keys

​
Authentication

Include in request headers: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.tiquo.co/v1/customers

​
Example Request

const response = await fetch('https://api.tiquo.co/v1/customers', {
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  }
});

API Introduction

API documentation

Authentication

Auth details

Webhooks

Event notifications