Webhook (Data Stream) enables real-time data transmission from Insider One to endpoints managed by your organization. It allows you to receive user events and attribute changes as soon as Insider One collects them, helping you connect Insider One with external systems and automate downstream processes.
Webhook supports two data streams:
Attribute Stream: Sends a webhook whenever one of the selected user attributes changes. You can choose which user attributes to monitor based on your integration requirements.
Event Stream: Sends a webhook whenever one of the selected Insider One events occurs, enabling your systems to process user activity in real time.
How Webhook data is delivered
Webhook sends the selected Insider One data to an endpoint that you manage. Depending on the stream you configure, the payload contains either user attribute changes or event data.
Payload format
Insider One delivers webhook data as a JSON payload. You can use the default payload generated from your selected events, event parameters, and user attributes, or configure a custom payload that matches the requirements of the receiving system.
Attribute Stream payloads include the changed user attributes, trigger details, the user's Insider ID, webhook ID, partner name, and timestamp.
Event Stream payloads include the event name, selected event parameters, selected user attributes, the user's Insider ID, webhook ID, partner name, and timestamp.
For the complete Attribute Stream and Event Stream schemas and JSON examples, refer to the Insider One Webhook Configuration.
Delivery behavior
Webhook delivery is event-driven rather than scheduled. Insider One sends a webhook as soon as it collects the configured event or detects a change in one of the monitored user attributes.
You can configure endpoint-level throttling to control the number of requests sent to your endpoint. If requests arrive faster than your endpoint can process them, Insider One places the webhook requests in a queue for later delivery.
For more information about throttling, queue behavior, delivery attempts, and retry rules, refer to the Insider One Webhook Configuration.
Supported destinations
You can send webhook requests to an HTTP endpoint managed by your organization. This can include endpoints used by CRM platforms, inventory systems, workflow automation tools, internal applications, and other third-party systems.
Configure the endpoint URL, optional request headers, and webhook payload according to the requirements of the receiving system.
Get started
To set up a webhook, create an Attribute Stream or Event Stream, select the data you want to monitor, configure the payload, and add the destination endpoint.
Refer to Insider Webhook Configuration for configuration steps, complete payload schemas, JSON examples, throttling settings, queue behavior, retry rules, and testing instructions.