{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Integrations","type":"markdown"},"seo":{"title":"Webhook Output Streaming Integration","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"webhook-output-streaming-integration","__idx":0},"children":["Webhook Output Streaming Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This Webhook integration allows you to specify a streaming output connection from Treasure Data to your third-party service or platform of choice."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When creating the authentication for this integration, you specify the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["URL—the API endpoint of the service or platform you want to stream to"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API Key—a key that will authenticate the API calls made by the Webhook integration"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Later when using the Treasure Console to create a triggered activation, you can specify this webhook authentication and then specify the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The endpoint URL"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Custom headers for the API request"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Output payload"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Basic Knowledge of Treasure Data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Basic knowledge of the APIs supported by your third-party service or platform"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-cases","__idx":2},"children":["Use Cases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The primary use case for this streaming integration is to incorporate it into a real-time activation workflow. Here is an overview of how to configure that workflow:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the Integration Hub, create an authentication for this integration to communicate with the platform you want to use."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In a Real-time Journey, specify this authentication in your real-time triggered activation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"limitations","__idx":3},"children":["Limitations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["OAuth 2.0 is not supported."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Currently the integration does not check for duplication in request headers. You will need to ensure that you do not specify any duplicate headers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request payloads cannot exceed 250KB."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Limit of 32 custom request headers supported."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["RT 2.0 Triggered Activation does not support PII-hiding."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"obtaining-the-webhook-api-key","__idx":4},"children":["Obtaining the Webhook API Key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You will need to have an API key to authenticate the API calls the integration will make to your third-party service or platform. Refer to the third-party documentation on how to obtain a key with sufficient privileges to support streaming output from the Webhook integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Treasure Console to Create Your Connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must create and configure the data connection in Treasure Data. As part of the data connection, you provide authentication credentials to access the integration."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure Console"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations Hub > Catalog"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select the search icon on the far right of the Catalog screen, and type ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Hover over the Realtime Webhook Activation connector and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Authentication"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/realtimewebhookcreateauth.04a51bf4560df93958ddb1a8f386113e49c5063c9e16a496c9a3eb3aa661dc7f.a62c81bb.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For URL Prefix, enter the baseURL of the API endpoint. All Webhook triggered activations using this Authentication must use a matching baseURL in their URL endpoint."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For API Key, enter the authentication secret of the webhook. When configuring the real-time triggered activation in Audience Studio, you can specify this secret using the variable {{auth.api_key}} in custom headers, in the API endpoint itself, or in the request body."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/newauthentication.beff2599d24b473bae3451f1c25eb5105f073c3cd494a4089203daef048e64c4.a62c81bb.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter a name for your authentication."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Done."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Webhook Output Streaming integration is now available to be incorporated into real-time customer journey activations. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/creating-a-real-time-triggered-activation"},"children":["Creating a Real-time Triggered Activation"]}," for additional information."]}]},"headings":[{"value":"Webhook Output Streaming Integration","id":"webhook-output-streaming-integration","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Use Cases","id":"use-cases","depth":2},{"value":"Limitations","id":"limitations","depth":2},{"value":"Obtaining the Webhook API Key","id":"obtaining-the-webhook-api-key","depth":2}],"frontmatter":{"seo":{"title":"Webhook Output Streaming Integration"}},"lastModified":"2026-06-01T09:09:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/int/webhook-output-streaming-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}