Frequently Asked Questions
General
Section titled “General”What is Klozeo? Klozeo is the lead database your automations write to, and your team and AI assistants read from. You store, score, filter, and query business leads via REST API or natural language through MCP-compatible AI clients (Claude, Cursor, Cline, etc.).
What’s the difference between updated_at and last_interaction_at?
updated_at: changes only when a structural field (name, email, city, etc.) is modified.last_interaction_at: updates on every API push, including merges where no field changed.
Use last_interaction_at to sort by “freshness of interest” independently of data changes.
Are timestamps in milliseconds or seconds?
All timestamps are Unix seconds (not milliseconds). For JavaScript: new Date(timestamp * 1000).
Authentication
Section titled “Authentication”Where do I get an API key? Sign in at klozeo.com/dashboard → API Keys → Add new. The raw key is shown once: copy it immediately.
What if I didn’t copy my API key in time? Delete the key from the dashboard and create a new one. It takes 10 seconds.
Can I have multiple API keys? Yes. Create as many keys as you need (e.g., one per integration). Revoke any key individually without affecting the others.
What happens to a revoked key? It is deleted immediately and stops working everywhere. Only its name and its creation and revocation dates are kept, for your audit trail, until you delete your account.
How do I delete my account? Dashboard → Settings → Delete account, then confirm with your password. Your account and all its data (leads and their history, scoring rules, API keys, webhooks, team members and invitations) are deleted and your subscription is cancelled. Invoices already issued are kept by Stripe for accounting.
Can I sign in with a passkey? Yes. A passkey signs you in with your fingerprint, face or screen lock, and asks for no two-factor code. Add one in Settings → Passkeys → Add a passkey; your password keeps working. Removing a passkey disconnects the AI assistants you connected by signing in. → Account security
What happens when I push a duplicate lead?
Klozeo checks every new lead against your existing leads by email, then SIREN, then source_id, then phone plus a similar name, and merges it into the first match. A same name and city only flags a possible duplicate. See the Deduplication guide.
Does batch create run deduplication?
Yes. POST /leads/batch runs the same per-item deduplication as single POST /leads. Duplicates are merged and returned as successes with duplicate: true; merges do not consume a slot from your leads limit. See Batch operations and Deduplication.
What is the free plan limit? Free accounts have one user, can store up to 2,500 leads and make 250 API requests per 10 minutes. Pro costs $30 (€30 in the eurozone) per month for 50,000 leads and 2,500 requests/10 min. Scale costs $80 (€80) per month for 250,000 leads and 5,000 requests/10 min. Prices exclude VAT and are per workspace, with team seats included.
Can I import leads in bulk?
Yes: use POST /leads/batch (up to 100 on Free, 500 on Pro and Scale) or import a CSV or JSON file from the dashboard.
What happens if I hit the lead limit?
New leads return 403 leads_limit_reached. Existing leads and all other operations continue normally. Upgrade to Pro to increase your limit.
Which AI clients are supported? Claude Desktop, Claude Code, Cursor, Cline, Roo Code, Smithery, and Goose. Any MCP-compatible client that supports HTTP or SSE transports will work.
Do I need to share my API key with the AI client? For most clients (Claude Code, Cursor, Cline, Goose): no. A browser-based authorization flow generates and stores the key automatically. Claude Desktop currently requires a manual key in its config.
Pricing & billing
Section titled “Pricing & billing”Is a credit card required? No. Every new account starts with a 14-day Pro trial, without payment information. Settings and the dashboard sidebar show the days left, and the account owner gets an email 3 days and 1 day before the trial ends.
What happens when the trial ends? Unless you upgrade, the account moves to Free. Nothing is deleted. Leads remain readable. In an editable Free workspace, the owner can still edit existing leads, but cannot add new leads above 2,500. Invited members keep read-only access, and you cannot invite new ones. If you upgrade later, members get their roles back. If you own more than one Free workspace, only one stays editable. → When a Free workspace becomes read-only
How do I upgrade from Free to Pro? Select the workspace, go to Settings in your dashboard and click “Upgrade”. Only the workspace owner can subscribe it, and each workspace you own has its own plan and subscription, billed to you. You’ll be redirected to the Stripe checkout. If a new checkout opens, the earlier checkout is cancelled and can no longer be paid. Your plan is activated as soon as Stripe confirms the payment, usually within seconds; Settings shows “activating your plan” until then.
What are the differences between Free and Pro? Free: one user, 2,500 leads, 250 API requests per 10 minutes. Pro: team seats, 50,000 leads, 2,500 requests per 10 minutes ($30 or €30 per month, excl. VAT). Scale: 250,000 leads, 5,000 requests per 10 minutes ($80 or €80 per month, excl. VAT).
Do prices include VAT? No. Prices exclude VAT: €30 and €80 per month in the eurozone, $30 and $80 elsewhere. Checkout asks for your billing address and adds VAT where it applies, for example 20% for a customer in France. A business in the EU outside France can enter its VAT number at checkout: VAT is then reverse-charged and not added. Invoices show the VAT amount, our VAT number, and yours if you entered one.
What is the founder price? While the founder offer is open, Checkout applies a founder price to Pro and Scale for your first workspace; the earliest subscribers get the lowest one. You keep it for as long as your subscription stays active, including when you switch between Pro and Scale. It ends if you cancel: if you subscribe again later, you pay the normal price, even while the offer is open. An unfinished Checkout keeps your place until it expires, after one hour; opening a new Checkout replaces the previous one. Your other workspaces pay the standard price.
Can I cancel my subscription? Yes, at any time from Settings → Manage billing, which lists every subscription you pay for. Cancel the one for the workspace you want to stop. You keep that workspace’s paid plan until the end of the billing period, then it moves to Free (not back to a trial). If you then own several Free workspaces, only one stays editable. Your invoices stay available from Settings → Manage billing after a workspace returns to Free.
What happens if a payment fails? You keep your plan while Stripe retries the card, and you can update it from Settings → Manage billing. Until the payment goes through, changing plan in that workspace’s Settings also opens Manage billing, so you settle the payment before changing plan and are never charged twice for the same workspace. If the retries fail and Stripe ends the subscription, that workspace returns to Free: existing leads are kept, but new leads cannot be added above 2,500, and invited members become read-only. If you own several Free workspaces, only one stays editable, including for the owner and API keys.
What payment methods are accepted? Credit and debit cards via Stripe (Visa, Mastercard, American Express).