Skip to content

Overview

The Zimark REST API uses an API key authentication via the X-AUTH-KEY header.

To access the Zimark API, you must first create and securely store an API key. This guide explains how to generate a key, configure restrictions.

Prerequisites

  • ✅ Access to the Zimark Backoffice.
  • ✅ Appropriate permissions to manage API keys within your organization.

Create an API Key

  1. Navigate to AdministrationAPI Keys
  2. Click Add key
  3. Configure the key:
    • Enter a descriptive name and purpose
    • (Optional) Add IP restrictions Note: After creation, only IP restrictions can be modified. API key form API key form with IP restrictions
  4. Click Create
  5. Copy the key - it will not be shown again API key modal

Security: Store the key securely. After creation, only IP restrictions can be modified.

Include the API key in every request:

  • Header name: X-AUTH-KEY
  • Value format: ZIM.***************