SpaceKru for Developers

Connect SpaceKru to the rest of your business.

Run SpaceKru from your own platform. Sync leads, deals, products, sales and bookings in both directions, add leads to campaigns, let your AI Employee follow up and chat with your customers inside your app — with real-time signed webhooks and a clean REST API your developer can learn in an afternoon.

Start the 5-minute quickstart · Two-way sync with your platform · OpenAPI 3.1

Available on every paid plan — including the 7-day free trial.

REST + JSON · Two-way sync · AI conversations · Signed webhooks · OpenAPI 3.1

The SpaceKru API (v1.1) is a REST/JSON API available on every paid SpaceKru plan. It syncs leads both ways (upsert by external_id), adds leads to campaigns, creates and moves deals and asks AI Employees to follow up, manages products, quotes, orders, payments and bookings, lets your platform chat with your Customer Service AI Employee, and sends signed webhooks for 16 events that say who caused each change. Base URL: https://app.spacekru.com/api/public/v1. Authentication: Bearer API key (sk_live_…). Documentation: https://www.spacekru.com/developers (Spanish: https://www.spacekru.com/es/developers). OpenAPI 3.1: https://app.spacekru.com/api/public/v1/openapi.json.

Leer en español

What you can do — and what you can't

The API has 48 operations. Here is exactly what it does today.

What you can do today

  • Sync leads both ways. Create, update and upsert leads by YOUR id (external_id), with duplicate protection, and hear about every change made in SpaceKru.
  • Put leads in campaigns. Add a lead to a prospecting or recontact campaign when you create it, or in batches, with the same reachability rules as the app.
  • Work your pipeline. Create deals, move them between stages, mark them won or lost, and ask the deal's AI Employee to follow up.
  • Sell. Manage products, prices and stock; create and edit quotes; convert them into orders; record payments.
  • Book. Read free slots and create, reschedule or cancel bookings, with the shifts and capacity of each resource.
  • Chat with your AI Employee. Your Customer Service AI Employee answers your customers inside your own app or website.
  • Get notified in real time. Signed webhooks for 16 events, each one saying who caused the change.

What you can't do yet

  • Delete records. Use status: archived (products), cancelled (orders, bookings) or lost (deals) instead.
  • Email quotes or orders. Creating a quote never emails it. Order confirmations go to the customer only with notify_customer: true.
  • Create campaigns, AI Employees or pipeline stages. They are configured in the app; the API reads them so you can use their ids.
  • Set a lead's status or source. SpaceKru's workflow manages status. Leads created through the API are marked with source api.
  • Send files in conversations. AI conversations are text only.
  • Call the API from a web browser. It's server-to-server only, by design, so your key never ends up in a web page.
  • Use a test mode. Every key is live (sk_live_…). Tag your test leads so you can find and remove them.
  • Use the API without a paid plan. Requests answer 402 PLAN_UPGRADE_REQUIRED.

Connect anything

  • Your own platform: POS, ERP, booking or e-commerce system: two-way sync of leads, deals, products, sales and bookings.
  • Your app or website chat: Your Customer Service AI Employee answering inside your product.
  • Zapier: Use Webhooks by Zapier to send leads in and Catch Hook to react to events.
  • Make: Use the HTTP module to call SpaceKru and a Custom webhook to receive its events.
  • n8n: Use the HTTP Request node with Header Auth, and a Webhook node.
  • HubSpot & other CRMs: Mirror SpaceKru leads as contacts, through Zapier, Make, n8n or your own code.

What teams build with it

See all use cases, each with its flow step by step.

Plans

The API and webhooks are included in every paid SpaceKru plan, including the 7-day free trial of a paid plan, at no extra cost. There is no per-request charge.

  • Each key: 120 requests per minute and 10,000 per day by default (rate limits).
  • Up to 5 active keys and 50 active webhooks per account.
  • Products, quotes, orders and payments need the Sales module of your plan; bookings, the Scheduler module (every paid plan includes both today).
  • If the account leaves its paid plan, requests answer 402 and webhooks pause automatically. Nobody needs to revoke anything.

Is it secure?

  • Your keys are never stored in readable form. We keep only a keyed hash (HMAC-SHA256); the key is shown once, when it is created.
  • Least privilege. Choose Read only or Read & write for each key, and grant AI conversations only to the keys that need it. Revoking a key takes effect on the very next request.
  • Your data only. A key belongs to one organization. Asking for another organization's record returns "not found".
  • Signed, HTTPS-only webhooks. Every delivery carries an HMAC-SHA256 signature and a timestamp. We only deliver to public HTTPS addresses and never follow redirects.

More in Authentication & keys.

Frequently asked questions

Which plans include the API?
Every paid SpaceKru plan, including the 7-day free trial of a paid plan. Organizations that are not on an active paid plan get 402 PLAN_UPGRADE_REQUIRED.
Do I need a developer?
Not for most Zapier, Make or n8n flows: sending leads into SpaceKru is point-and-click. Receiving SpaceKru events needs one extra step — registering a webhook with a single request we give you ready to copy. See Zapier, Make & n8n. Connecting your own platform both ways is a job for your developer: start with Two-way sync.
Can my platform both send and receive changes without loops?
Yes. Store your own id in external_id, write with PUT /leads/external/{external_id}, and subscribe with exclude_own_changes: true: changes your key made are never sent back to it. Every webhook also says who caused it in triggered_by. See Two-way sync.
Can I use my AI Employee inside my own app?
Yes, your Customer Service AI Employee, with the AI conversations scope: your platform sends the customer's message and gets the reply, with the same tools as in WhatsApp (quotes, bookings, catalog, knowledge base). Each reply uses your AI tokens. See AI conversations.
What happens if I downgrade or my payment fails?
Within about a minute, requests start answering 402 and webhooks stop being delivered — automatically, with no grace period. Events that happen in the meantime are not sent later. Go back to a paid plan and the same keys and webhooks work again.
Is there a cost per request?
No. There is no per-request charge. Each key has a limit: 120 requests per minute and 10,000 per day by default. Only AI conversations use AI tokens, like any reply of your AI Employees.

Changelog

  • v1.1 — October 20, 2026: two-way sync (external_id, upsert, triggered_by, exclude_own_changes), campaigns and enrollment, deal writes and AI follow-ups, products, quote and order writes, payments, bookings, AI conversations, 16 webhook events, error messages in English and Spanish. Everything in v1 keeps working unchanged.
  • v1 — October 19, 2026: initial release. Leads (create, update, read, notes), deals, quotes and orders (read), 9 webhook events.