Skip to main content
The Gliiv API uses API keys to authenticate requests. This ensures that every message sent programmatically is authorized and linked to your specific account.

​
Obtaining your API Key

To get started, you need to generate a unique key from your dashboard.
  1. Navigate to the API Settings page.
  2. If no key is present, click Generate New Key.
  3. Copy and save your key immediately.
Important: For security reasons, your API key is only shown once at the moment of generation. Once you navigate away or refresh the page, you will not be able to retrieve the full key again. If you lose it, you must delete the existing key and generate a new one.

​
Header Authentication

All API requests must include the x-api-key header. Requests that omit this header or provide an invalid key will be rejected with a 401 Unauthorized response.

​
Header Specification

​
x-api-key
string
required
Your secret API key (formatted as gliiv_xxxxxxxxxxxxxxxx).

​
Example Header

Your request headers should be structured as follows:

​
Security Best Practices

  • Server-Side Only: Never expose your x-api-key in client-side code, frontend JavaScript, or public repositories.
  • Storage: Store your key securely using environment variables or a secrets management service.
  • Replacement: If you suspect your key has been compromised, revoke it immediately in the dashboard and generate a replacement.