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.
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) orlost(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
- Walk-in customer → campaign: A customer served in person becomes a lead in a follow-up campaign in one request.
- Two-way CRM sync: Edit a lead on either side and both stay identical, without loops.
- AI Employee in your app: Your customers chat with your AI Employee inside your product.
- Deal won → Slack: Celebrate wins where your team already talks.
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
402and 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 withPUT /leads/external/{external_id}, and subscribe withexclude_own_changes: true: changes your key made are never sent back to it. Every webhook also says who caused it intriggered_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
402and 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.