Quickstart

Zooza offers two integration approaches. Choose the one that fits your needs — or use both.

---

Widgets quickstart

Embed your first widget (5 min)

Widgets are pre-built Zooza components that you embed directly on your website. No authentication or server code required.

Prerequisites

• A Zooza account with at least one programme
• An HTTPS website to embed on

Step 1: Get your widget API key

1. Log into the Zooza app.
2. Go to Team & Settings > Publish.
3. Click on your widget name to open the detail view.
4. Copy your API key.

Step 2: Add the embed code

Paste these two lines into your HTML page where you want the registration form to appear. Replace YOUR_API_KEY with your actual widget API key, and ZOOZA_API_URL with your region's base URL.

<div data-zooza-widget='registration' data-zooza-id='YOUR_API_KEY'></div>
<script async src='ZOOZA_API_URL/widgets/v1/loader.js'></script>

For the Europe region, ZOOZA_API_URL is https://api.zooza.app.

Load faster from the head

You can move the loader <script> into your page <head> and keep only the placeholder <div> in the body — the widget then starts loading earlier. See Choosing an embed method.

Other widget types

Change data-zooza-widget to embed a different widget, and match the loader version: registration, profile and contact use v1; calendar, checkout, video and map use v2.

Step 3: Verify

Open your page in a browser. You should see a Zooza registration form displaying your programmes.

Next steps

• Customise your widget with filters and styling
• Explore other widgets: Calendar, Map, Profile, Contact
• Learn Zooza terminology

🤖

Build this with your AI agentEmbed my first Zooza widget

Open in ChatGPT ↗Open in Claude ↗

---

REST API quickstart

Make your first API call (10 min)

The REST API gives you full programmatic access to Zooza data — for admin tools, custom customer journeys, data caching, and more.

Different API keys

The REST API uses a different API key from widgets. A widget API key cannot be used for REST API calls.

Prerequisites

• A Zooza account with at least one programme
• Your REST API key and client secret — contact Zooza support to receive both
• cURL or Node.js installed

Step 1: Authenticate

Use your client secret to obtain a token:

cURL

curl -X POST https://api.zooza.app/v1/login \
  -H "Content-Type: application/json" \
  -H "X-ZOOZA-API-KEY: your_api_key" \
  -d '{
    "login": "your_email@example.com",
    "verification_method": "client_secret",
    "client_secret": "your_client_secret"
  }'

JavaScript

const response = await fetch("https://api.zooza.app/v1/login", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-ZOOZA-API-KEY": "your_api_key",
  },
  body: JSON.stringify({
    login: "your_email@example.com",
    verification_method: "client_secret",
    client_secret: "your_client_secret",
  }),
});
const data = await response.json();
console.log("Token:", data.token);

Save the token from the response — you'll need it for all subsequent requests.

Step 2: Get your company ID

cURL

curl -X GET https://api.zooza.app/v1/user \
  -H "X-ZOOZA-API-KEY: your_api_key" \
  -H "X-ZOOZA-TOKEN: your_token"

JavaScript

const response = await fetch("https://api.zooza.app/v1/user", {
  headers: {
    "X-ZOOZA-API-KEY": "your_api_key",
    "X-ZOOZA-TOKEN": "your_token",
  },
});
const data = await response.json();
console.log("Companies:", data.user.companies);

Find your company in the user.companies array and note the id.

Step 3: Make an authenticated request

Now use all three headers to fetch your programmes:

cURL

curl -X GET https://api.zooza.app/v1/courses \
  -H "X-ZOOZA-API-KEY: your_api_key" \
  -H "X-ZOOZA-TOKEN: your_token" \
  -H "X-ZOOZA-COMPANY: your_company_id"

JavaScript

const response = await fetch("https://api.zooza.app/v1/courses", {
  headers: {
    "X-ZOOZA-API-KEY": "your_api_key",
    "X-ZOOZA-TOKEN": "your_token",
    "X-ZOOZA-COMPANY": "your_company_id",
  },
});
const courses = await response.json();
console.log("Courses:", courses);

You should see a list of your programmes (called "courses" in the API).

Next steps

• Authentication guide — all login methods explained
• API endpoints — full reference
• Error handling — status codes and troubleshooting
• Concepts and glossary — understand Zooza terminology

🤖

Build this with your AI agentBuild a Zooza REST API integration

Open in ChatGPT ↗Open in Claude ↗