Skip to main content
  1. On a Zenzap admin user, go to https://app.zenzap.co/console
  2. Create a new API key with the needed permissions
  3. Copy the API key and secret from the API key settings
When creating an agent or bot, the console provides an API Base URL alongside the credentials. Use that URL as the base for all API calls — it is region-specific and may differ from the default https://api.zenzap.co.
  1. For each request:
    • Add the Authorization header with your API key
    • Generate a Unix timestamp in milliseconds
    • Calculate the HMAC-SHA256 signature:
      • For POST/PUT/PATCH/DELETE: Sign {timestamp}.{body}
      • For GET: Sign {timestamp}.{uri} (for example /v2/members?limit=10&offset=0)
    • Add X-Signature with the hex-encoded signature
    • Add X-Timestamp with the same timestamp used in the signature payload