Webhooks let Smartsupp send real-time notifications to any URL you choose — the moment a conversation opens, a contact is created, or a message is delivered, your system knows about it. This article explains what webhooks are, how to set them up in your dashboard, and how to connect them to automation platforms like Make and n8n.
We've broken the article into a few sections:
What are webhooks good for?
A webhook is an automatic HTTP message Smartsupp sends to a URL of your choice whenever a selected event happens. Instead of polling for changes, your tools get data pushed to them the moment something occurs.
Typical use cases include:
Automation platforms — trigger workflows in Make, n8n, or similar tools to add contacts to a CRM, post notifications to Slack, or log leads in a spreadsheet
Internal systems — feed conversation and contact data into dashboards, data warehouses, or ticketing systems in real time
Notifications — alert your team when conversations are rated or when message delivery fails
Tip: Webhooks are available on the Plus plan and above — Plus includes 1 webhook, Expert includes 3, and Ultimate offers a custom limit. Compare plans →
Create a webhook
Setting up a webhook takes just a few steps inside your Smartsupp dashboard:
1. Open Settings and navigate to the Webhooks section.
2. Click to add a new webhook and enter your endpoint URL — the address where Smartsupp will send event data.
3. Select the events you want to receive (see the full list in the next section).
4. Save the webhook. From that point on, the selected events are delivered as HTTP POST requests with JSON payloads.
Note: Previously configured webhooks continue operating normally. Efforts are underway to make all existing webhooks visible and manageable from the new dashboard section.
Available events
Smartsupp can notify your endpoint about events across three categories. Select only the events your workflow actually needs — this keeps your endpoint lean and avoids unnecessary traffic.
Contacts
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Conversations
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Visitors
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Related resources: Smartsupp developer docs — full JSON payload schemas for every event type.
Test your webhook
Before going live, use the built-in test feature to verify your endpoint is reachable and your Make or n8n scenario is set up correctly.
From your webhook settings in the dashboard, click Send test. Smartsupp will dispatch a sample payload to your endpoint URL. Check your receiving service to confirm the data arrived in the expected format.
Tip: In Make, your scenario must be active and listening before you send the test. In n8n, switch the Webhook node to its production URL and make sure the workflow is active.
Delivery, retries, and security
Smartsupp is designed to deliver webhook events reliably, even when your endpoint is temporarily unavailable.
Format — all events are sent as HTTP POST requests with a JSON body describing the event and its data
Response — your endpoint should respond with a 2xx HTTP status code as quickly as possible; slow responses can delay retries
Retries — if delivery fails, Smartsupp retries with increasing delays for up to 3 days
Automatic disabling — endpoints that fail persistently are automatically disabled; you can re-enable them in the dashboard at any time
Security — every webhook request is signed so you can verify it genuinely came from Smartsupp; see docs.smartsupp.com for the signature verification details
Note: If your endpoint is disabled due to repeated failures, re-enable it in Settings → Webhooks after fixing the underlying issue. Smartsupp will resume sending events immediately.
Connect Smartsupp to Make or n8n
Connecting Smartsupp to an automation platform takes four steps. The process is the same for Make and n8n — only the trigger node differs.
1. In Make, add a Webhooks → Custom webhook trigger and copy the generated URL. In n8n, add a Webhook trigger node and copy its production URL.
2. In Smartsupp, go to Settings → Webhooks, create a new webhook, and paste the copied URL.
3. Select the events you need and save the webhook.
4. Click Send test so Make or n8n captures the data structure — then build the rest of your scenario or workflow on top of it.
Tip: In Make, activate your scenario before sending the test — otherwise the webhook data won’t be captured. In n8n, use the production URL (not the test URL) when setting up the Smartsupp webhook.
What’s next?
Smartsupp REST API — explore the full API to read and write Smartsupp data programmatically.
Automations — set up rule-based automations that trigger directly inside Smartsupp without an external tool.
Integrations overview — see all available native integrations with CRMs, e-commerce platforms, and more.
💡 Need more help? Contact our support team — we’re happy to assist!





