Connections
Integrations and API
Connect Spjallbox to your online store, CRM, accounting software and your own systems — with webhooks, an open API, or ready-made integrations.
Reading time · 7 min read
Besides email and social channels (covered on their own pages), Spjallbox offers integrations that pull data into the conversation panel or push data out of the system. All of them live under Settings → Integrations, and Settings → Developers for API keys and webhooks.
E-commerce and CRM
Shopify
Store domain (e.g. store.myshopify.com) + Admin API Access Token — shows a customer’s recent orders directly in the conversation.
WooCommerce
Store URL (HTTPS), Consumer Key and Consumer Secret — same idea as Shopify, for WordPress/WooCommerce stores.
HubSpot
Private App Access Token — shows a contact’s CRM details while an agent handles a case.
Salesforce
Instance URL + Connected App Access Token — fetches contact and account details from Salesforce.
Every integration is set up the same way: paste your keys/token into the relevant tab, click "Test connection" to confirm it can reach the service, then Save.
Accounting: Payday
Connect Payday with an API Bearer Token and Company ID (optional) to see a customer’s invoices right inside the conversation — handy when a customer asks about an unpaid invoice without an agent needing to check a separate system.
Payday here is the accounting integration for information inside the conversation panel — don’t confuse it with Teya, the payment processor that handles Spjallbox’s own subscription charges on the Billing page.
Webhooks — sending data out
Under Settings → Developers → Webhooks you can register one or more URLs that receive a POST request every time something happens in Spjallbox. Choose which events should trigger the webhook:
- Conversation created
- Conversation updated
- Conversation closed
- Conversation resolved
- Conversation assigned
- New message
- 1
Add a webhook
Enter your URL (e.g. https://yourapp.com/webhooks/spjallbox) and check the events you want to receive.
- 2
Test it
Click "Test" to get a delivery immediately and confirm your endpoint responds.
- 3
Verify the signature (recommended)
Spjallbox signs every delivery so you can confirm on your end that it genuinely came from Spjallbox.
API channel — sending cases in from other systems
Under Settings → Developers → API channel you’ll find your secret key (starts with sk_…). Use it to send requests into Spjallbox directly from your own backend, without going through email or the web UI:
POST a request to /api/ingest with the header x-api-key and a JSON body containing name, email, subject and message — a new case appears instantly in the inbox.
Guard the secret key
The API key grants access to your inbox — keep it strictly server-side, never in code that runs in a customer’s browser.
Zapier, Make and n8n
The same API channel above can be used directly as an "HTTP request" step in Zapier, Make or n8n, so you can connect Spjallbox to almost any system without custom code — for example sending every new website form submission into Spjallbox, or the other way around: triggering an action elsewhere when a case is closed.
Do I need a developer to set up the integrations?+
The e-commerce and CRM integrations (Shopify, WooCommerce, HubSpot, Salesforce, Payday) just need keys pasted in — no coding. Webhooks and the API channel are best suited to someone with developer access.
Can I rotate the API key if it leaks?+
Contact support to have a new key issued if the old one may have been exposed.
Is there public API documentation?+
The API channel and webhooks are documented directly on the Developers page with runnable examples — no need to look anything up externally to get started.