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
The API base URL depends on your organization’s data residency:
You can find your organization’s data residency in the Admin tab under Workspace Settings. When creating an agent or bot, the console also provides the correct API Base URL alongside the credentials.
  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