CLOOZR PUBLIC API

Connect Cloozr to your sales stack

REST API to integrate Cloozr with HubSpot, Salesforce, Zapier, Make and any custom workflow.

Authentication

All requests must include your API key in the Authorization header:

Authorization: Bearer cloozr_live_xxxx...

Base URL:

https://cloozr.com/api/v1

Endpoints

GET/api/v1/sessions

List your sessions

Query params: limit (max 100), offset, status (all|completed|in_progress)

RESPONSE

{
  "data": [{
    "id": "uuid",
    "prospect_name": "Alexandre Elbaz",
    "prospect_company": "Cyna",
    "score": 74,
    "duration_sec": 847,
    "started_at": "2026-04-27T13:30:00Z",
    "status": "completed",
    "objections_count": 3,
    "meddic_score": 68
  }],
  "total": 42, "limit": 20, "offset": 0
}

GET/api/v1/sessions/:id

Get a single session

Includes MEDDIC, objections, transcript and brief.

RESPONSE

{
  "id": "uuid",
  "prospect_name": "...", "prospect_company": "...",
  "score": 74, "duration_sec": 847,
  "statut_deal": "negociation",
  "meddic": { "metrics": {...}, ... },
  "objections": [...],
  "transcript": [...]
}

GET/api/v1/sessions/:id/report

Get the post-call AI report

Returns null if not yet analyzed.

RESPONSE

{
  "session_id": "uuid",
  "score_global": 74,
  "resume": "...",
  "points_forts": [...],
  "points_a_ameliorer": [...],
  "meddic": { "metrics": { "score": 80, "status": "fort", "evidence": "...", "gap": "..." }, ... },
  "prochaines_actions": [...],
  "next_step_recommande": "..."
}

POST/api/v1/brief

Generate a pre-call brief

Scope required: brief:read

REQUEST

{
  "prospect_name": "Alexandre Elbaz",
  "prospect_company": "Cyna",
  "prospect_domain": "cyna-it.fr",
  "language": "en"
}

RESPONSE

{ "resume": "...", "pains": [...], "angles": [...], "questions": [...], "objections_probables": [...], "insights_web": [...], "sources": [...] }

GET/api/v1/competitors

List your configured competitors

RESPONSE

{ "data": [{ "id": "uuid", "name": "Gong", "their_strengths": "...", "why_we_win": "..." }] }

GET/api/v1/analytics

Get your performance stats

Aggregated for the current month.

RESPONSE

{
  "sessions_this_month": 8,
  "avg_score": 71,
  "top_objection": "Price",
  "meddic_avg": { "metrics": 45, "economic_buyer": 30, ... },
  "sessions_by_week": [...]
}

POST/api/v1/webhooks

Configure a webhook URL

Receive Cloozr events in real time. Events: session.completed, objection.detected, deal.signed.

REQUEST

{
  "url": "https://your-server.com/webhook",
  "events": ["session.completed", "objection.detected", "deal.signed"]
}

RESPONSE

{ "id": "uuid", "url": "...", "events": [...], "secret": "whsec_..." }

Webhook events

Every delivery is signed with HMAC-SHA256. Verify the X-Cloozr-Signature header against your secret.

{
  "event": "session.completed",
  "timestamp": "2026-04-27T14:30:00Z",
  "data": { "session_id": "uuid", "score": 74, "prospect_name": "Alexandre Elbaz" }
}

Code examples

cURL

curl -X GET https://cloozr.com/api/v1/sessions \
  -H "Authorization: Bearer cloozr_live_xxxx" \
  -H "Content-Type: application/json"

JavaScript

const res = await fetch('https://cloozr.com/api/v1/sessions', {
  headers: {
    'Authorization': 'Bearer cloozr_live_xxxx',
    'Content-Type': 'application/json'
  }
});
const data = await res.json();

Python

import requests
r = requests.get(
  'https://cloozr.com/api/v1/sessions',
  headers={'Authorization': 'Bearer cloozr_live_xxxx'}
)
print(r.json())

Make / Zapier

Use a "Webhooks by Zapier" or "HTTP" module.
URL: https://cloozr.com/api/v1/sessions
Header: Authorization: Bearer cloozr_live_xxxx

Errors

{ "error": { "code": "UNAUTHORIZED", "message": "Invalid or missing API key.", "docs": "https://cloozr.com/api-docs" } }

UNAUTHORIZED (401) — invalid or inactive API key
FORBIDDEN (403) — wrong scope or plan
NOT_FOUND (404) — resource not found
RATE_LIMITED (429) — too many requests
SERVER_ERROR (500) — internal error

Popular integrations

HubSpot

Sync sessions as CRM activities

View guide → (coming soon)

Salesforce

Update opportunity MEDDIC scores

View guide → (coming soon)

Zapier

Connect to 6000+ apps

View guide → (coming soon)

Make

Build automated workflows

View guide → (coming soon)

Slack

Get session summaries in Slack

View guide → (coming soon)

Notion

Export reports to Notion

View guide → (coming soon)