HELP CENTER

How can we help?

Guides, API reference, and answers for setting up Cadey, from your first booking link to production webhooks.

BROWSE BY TOPIC

Start where you are

GUIDES

Popular guides

API REFERENCE

REST API

Available on every paid plan. Base URL https://api.cadey.ai/v1

Authentication

Pass a scoped, workspace-level key as a Bearer token. Create and revoke keys in Settings → API & webhooks.

Core endpoints
POST/leadsCreate / upsert
GET/leads/:idRetrieve
GET/meetingsList booked
POST/event-types/:id/bookBook on behalf
GET/conversationsList threads
POST/ticketsOpen a ticket
POST/articlesAdd to KB
DEL/webhooks/:idRemove
Request example
# Authenticated request
curl https://api.cadey.ai/v1/leads \
  -H "Authorization: Bearer ck_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "mia@acme.com",
    "source": "website",
    "score": 87
  }'

# 200 OK
{ "id": "lead_8fK2", "synced": true }
Rate limits, 60/min (Basic·Starter) · 300/min (Pro) · 1,000/min (Scale)Idempotent, send an Idempotency-Key header on POSTsPagination, cursor-based via ?after=
WEBHOOKS

Signed events, delivered in real time

Every payload is signed with an HMAC-SHA256 header. Verify it before trusting the body.

lead.createdA new lead was captured or upserted
meeting.bookedA meeting was scheduled on a calendar
meeting.canceledAn attendee canceled or no-showed
conversation.closedAn AI or human thread ended
ticket.createdThe agent escalated to a ticket
deal.stage_changedA pipeline deal moved stage
verify(req) {
  const sig = req.headers['cadey-signature'];
  const digest = hmacSHA256(req.rawBody, CADEY_SIGNING_SECRET);
  return timingSafeEqual(sig, digest); // reject if false
}
FAQ

Frequently asked

Most teams are live in under five minutes: paste your website URL, let Emily crawl it for an initial knowledge base, connect a calendar, and drop the widget script on your site. Everything else, training, routing, branding, you refine over time.
Only from your knowledge base, uploaded documents, and the Q&A and rules you set. Every answer is grounded and cites its source; when Emily can't find an answer she refuses honestly and logs an answer gap rather than guessing.
Yes. Any teammate can jump into a live thread from the Inbox; Emily steps back instantly and can be handed control again. Threads a human takes over before the AI's first substantive reply are never billed as a conversation.
No. The widget is a single script tag with one-click helpers for WordPress, Shopify, Webflow, and Google Tag Manager. Calendar and CRM connections are OAuth. The REST API and webhooks are there when you want to go deeper.
No. Your content grounds only your own agent and is never used to train models shared across tenants. Workspaces are isolated, and Scale plans add SSO, audit logs, and SIEM export.
CHANGELOG

What's new

Jun 10, 2026
New

Routing forms with AI-collected fields

Add fields the agent infers from the conversation, no question asked, and route by AI-interpreted conditions to the right event type or rep.

Jun 2, 2026
Improved

Landing page builder

Launch on-brand capture pages from a template, with form fields, banner upload, and a custom domain, branding inherits from your account.

May 24, 2026
New

Deals pipeline

A full kanban pipeline with weighted forecast and two-way HubSpot & Salesforce sync now lives alongside Leads in CRM.

May 15, 2026
Fixed

Calendar conflict edge case

All-day events on secondary calendars no longer block same-day availability when "check for conflicts" is enabled.

STILL STUCK?

Talk to a human

Our team answers in minutes during business hours, and yes, you'll usually chat with Emily first.