Connect SpaceKru with Zapier, Make & n8n

Before you start

• A SpaceKru account on a paid plan (the 7-day free trial works).
• An API key with Read & write access, created by the account owner in Integrations → API & Webhooks. Name it after the tool ("Zapier", "Make", "n8n").
• The API base URL: https://app.spacekru.com/api/public/v1.

Two directions

Zapier

Send leads into SpaceKru

1. Trigger. Choose the app where leads come from (Typeform, Google Forms, Facebook Lead Ads, Shopify, a spreadsheet…).
2. Action: Webhooks by Zapier → POST. URL: https://app.spacekru.com/api/public/v1/leads. Payload Type: json. Headers: Authorization → Bearer sk_live_… (your key).
3. Data. One row per field: full_name, work_email, work_phone, company_name, city, country, tags… At least one email, phone or social profile is required. Unmapped or empty fields are ignored.
4. Test. A 201 response means the lead was created. 409 DUPLICATE_RESOURCE means it already existed (the response includes its existing_id).

Field names and limits: Create a lead. tags can be a comma-separated text such as zapier, webinar.

React to SpaceKru events

1. Trigger: Webhooks by Zapier → Catch Hook. Copy the URL Zapier gives you (https://hooks.zapier.com/hooks/catch/…).
2. Register the URL once. Run this request once, replacing the URL and choosing the event (lead.created, lead.updated, deal.created, deal.stage_changed, deal.updated, quote.created, quote.status_changed, order.created, order.status_changed, campaign_lead.replied, campaign_lead.form_submitted, product.created, product.updated, booking.created, booking.updated, conversation.message_created). Use a terminal, any HTTP tool (Postman, Insomnia), or a temporary Zap with a Webhooks by Zapier → POST step. Save the secret from the response.

   curl -X POST "https://app.spacekru.com/api/public/v1/subscriptions" \
     -H "Authorization: Bearer $SPACEKRU_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "event_type": "lead.created",
     "target_url": "https://hooks.zapier.com/hooks/catch/1234567/abcdefg/"
   }'

   const res = await fetch('https://app.spacekru.com/api/public/v1/subscriptions', {
     method: 'POST',
     headers: {
       Authorization: `Bearer ${process.env.SPACEKRU_API_KEY}`,
       'Content-Type': 'application/json',
     },
     body: JSON.stringify({
       "event_type": "lead.created",
       "target_url": "https://hooks.zapier.com/hooks/catch/1234567/abcdefg/"
     }),
   });
   const body = await res.json();
   if (!res.ok) {
     // Branch on body.error.code; quote body.error.request_id to support.
     throw new Error(`${body.error.code}: ${body.error.message} (request ${body.error.request_id})`);
   }
   console.log(body);

   import os
   
   import requests
   
   r = requests.post(
       "https://app.spacekru.com/api/public/v1/subscriptions",
       headers={
           "Authorization": f"Bearer {os.environ['SPACEKRU_API_KEY']}",
       },
       json={
           "event_type": "lead.created",
           "target_url": "https://hooks.zapier.com/hooks/catch/1234567/abcdefg/",
       },
       timeout=30,
   )
   body = r.json()
   if not r.ok:
       # Branch on body["error"]["code"]; quote body["error"]["request_id"] to support.
       raise RuntimeError(f"{body['error']['code']}: {body['error']['message']} (request {body['error']['request_id']})")
   print(body)

3. Send a sample. Make the event happen in SpaceKru (for lead.created, create a lead). Zapier receives it and shows every field: event, data.full_name, triggered_by, changes…
4. Build the rest of the Zap. Add your actions (Google Sheets, Slack, HubSpot, Gmail…) and publish.

Make

Send leads into SpaceKru

1. Module: HTTP → Make a request. URL: https://app.spacekru.com/api/public/v1/leads. Method: POST. Headers: Authorization = Bearer sk_live_….
2. Body. Body type: Raw. Content type: JSON (application/json). Request content: the JSON of the lead, mapping your trigger's fields, e.g. {"full_name": "{{1.name}}", "work_email": "{{1.email}}", "tags": ["make"]}.
3. Parse response. Turn on Parse response to use the new lead's id in later modules.

React to SpaceKru events

1. Add Webhooks → Custom webhook as the first module and copy its address (https://hook.<region>.make.com/…).
2. Register the address once with the request above (POST /subscriptions).
3. Make the event happen in SpaceKru so Make learns the data structure, then add your modules.

n8n

Send leads into SpaceKru

1. Create a credential of type Header Auth: Name Authorization, Value Bearer sk_live_….
2. Add an HTTP Request node: Method POST, URL https://app.spacekru.com/api/public/v1/leads, Authentication → Generic Credential Type → Header Auth (the credential above).
3. Turn on Send Body, Body Content Type JSON, and map the fields.

React to SpaceKru events

1. Add a Webhook node with HTTP Method POST and copy its Production URL (not the Test URL).
2. Activate the workflow — the production URL only listens while the workflow is active.
3. Register the production URL once with POST /subscriptions.
4. Self-hosted n8n must be reachable at a public https:// address on port 443: localhost, private IPs and internal hostnames are rejected.

Troubleshooting

More detail on every code: Errors.