Welcome to the Webhook Integration Guide for DemandSense. This feature allows you to seamlessly send visitor identification data from your DemandSense account to any external system. With a webhook in place, you can automate data sharing and enhance your integration with CRMs, analytics tools, marketing platforms, and more.
This guide will walk you through the process of setting up, managing, and troubleshooting your webhook connection.
Accessing and Setting Up Your Webhook #
Getting started with the webhook integration is easy and begins right within your DemandSense dashboard. First, log in to your DemandSense account and head over to the Settings section. Once there, click on the Integrations tab to reveal various integration options, including the dedicated Webhook subtab. This subtab serves as your central hub for all webhook-related configurations and management tasks.
From here, connecting a webhook is a straightforward process. Simply locate and click the Connect button. This action will open a convenient pop-up window where you can enter the URL of the external system you’d like to receive your visitor data. After inputting the URL, hit Save to finalize the setup. Upon successful saving, you’ll notice the webhook status immediately update to “Connected,” confirming that your integration is now active and prepared to transmit data automatically.
Managing Your Webhook #
Once your webhook is connected, you gain access to several management options to tailor how data is sent to your external system.
Webhook Status & URL #
The connected webhook URL is displayed in the interface along with its status. While connected, the URL field is locked and cannot be edited. To change the URL, you’ll need to disconnect and reconnect with a new one.
Integration Settings #
You can customize how events are delivered through two key settings:
- Send Only Company Profiles
Enable this option if you want to limit data transmission to identified companies only. When turned on, events related to individual visitors will be excluded. By default, this setting is disabled, meaning data for all identified visitors will be sent. - Send Repeat Visitors
This setting determines whether data for returning visitors is included. When enabled, repeat visits will trigger events just like first-time visitors. If disabled (the default), only new visitor data is sent.
Testing Your Webhook #
To ensure your webhook is functioning properly, click the “Send test event to your webhook URL” button. This sends a sample payload to your connected endpoint, helping you verify that data is being received as expected.
Disconnecting or Updating Your Webhook #
If you need to stop sending data to your external system, you can disconnect the webhook at any time by clicking the Disconnect button. This will deactivate the integration and remove the stored URL.
To reconnect or change the destination URL, simply return to the Webhook subtab and click Connect. Enter the new URL and save your changes to establish a new connection.
Troubleshooting Tips #
- If your test event fails, double-check that the destination URL is correct and your external system is ready to receive incoming POST requests.
- Make sure your firewall or server permissions aren’t blocking DemandSense requests.
- Reconnect the webhook if you’ve made changes to the destination system or URL structure.
Output JSON #
When DemandSense sends data through your webhook, it uses a clean, structured JSON format that’s easy for your external system to process. This standardized payload includes comprehensive visitor session details, company information, and individual contact data – all organized in a single, readable structure.
Why you need this: This JSON format ensures your CRM, marketing tool, or database can quickly parse and store the data without complex mapping. It eliminates guesswork and reduces integration errors, so you can focus on converting leads rather than troubleshooting data formats.
Here’s an example of the JSON payload your webhook will receive:
{
"time_from": "YYYY - MM - DD - HH-MM-SS",
"time_to": "YYYY - MM - DD - HH-MM-SS",
"records": 122,
"data": {
"success": true,
"timestamp": "2025-10-21T14:16:02.810195",
"records": 122,
"results": [
{
"session": {
“session_id”: “9e70faaa-fee4-46f9-9353-e674beca750o”
"session_date": "2025-10-07T03:24:15Z",
"session_referrer": "https://www.bing.com/",
"session_landing": "https://impactable.com/automated-messaging/?utm_campaign=DemandSense&utm_source=bing&utm_medium=ppc&utm_term=linkedin%20marketing%20tools",
"session_visited_pages": [
{
"url": "https://impactable.com/automated-messaging/?utm_campaign=DemandSense&utm_source=bing&utm_medium=ppc&utm_term=linkedin%20marketing%20tools",
"duration": 3
}
],
"session_duration": 3,
"session_country": "United States",
"session_state": "Oregon",
"session_city": "Silverton",
"session_visits_count": 2
},
"account": {
"job_company_name": "Impactable",
"job_company_website": "https://impactable.com",
"job_company_sic_code": "7311",
"job_company_naics_code": "541810",
"job_company_location_street_address": "123 Main St",
"job_company_locality": "Silverton",
"job_company_region": "Oregon",
"job_company_country": "United States",
"job_company_postal_code": "97381",
"job_company_size": "11-50",
"job_company_industry": "Marketing Services",
"job_company_linkedin_url": "https://linkedin.com/company/impactable",
"job_company_facebook_url": null,
"job_company_twitter_url": null,
"job_company_founded": 2018,
"job_company_description": "LinkedIn demand generation agency."
},
"prospect": {
"first_name": "Daniel",
"last_name": "Leon",
"job_title_level": "Manager",
"job_title_role": "Marketing",
"job_title": "Marketing Manager",
"linkedin_url": "https://linkedin.com/in/danielleon",
"twitter_url": null,
"facebook_url": null,
"emails": [
"daniel.leon@impactable.com",
"daniel.leon@gmail.com"
],
"personal_phone": null,
"work_phone": "+1 555 123 4567",
"business_phone": null,
"skills": ["LinkedIn Ads", "Demand Generation"],
"locality": "Silverton",
"region": "Oregon",
"country": "United States",
"street_address": null,
"postal_code": "97381",
"linkedin_connections": 1200
}
}
]
}
}
Wrapping Up #
Webhooks in DemandSense are built to make data integration as seamless and efficient as possible. By following the steps outlined in this guide, you can confidently connect, manage, and customize your webhook setup to match your workflow.
Should you run into any issues, our support team is always here to help.