{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Quickstart","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":"quickstart","__idx":0},"children":["Quickstart"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The beta release of the Live Connect API provides the tools to perform multi-table copies from the Snowflake or Databricks warehouses. Using the API you can"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["access the data warehouse to get a list of databases, tables, and table schemas."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["manage a set of input connector configurations as a single data warehouse integration configuration."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["enable a Digdag workflow to organize input connector jobs."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview-of-the-easy-sync-use-case-for-snowflake","__idx":1},"children":["Overview of the Easy Sync Use Case for Snowflake"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following video shows an example of how to use the Live Connect API. Here is the high-level flow of the steps shown in the video."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Using the Treasure Console, get the ID of your Snowflake authentication."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the Snowflake authentication ID to create a basic configuration and run Guess."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"POST /v1/guess with td_authentication_id in request payload\n...\nReturns: basic configs and advanced configs\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create integration with guessed result and config values."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"POST /v1/dwh/  including configs in request payload\n...\nReturns: {dwh_id} \n\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check status."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"PUT /v1/dwh/{dwh_id}/run_workflow\n...\nReturns: running status\n\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check workflow status in console or TD toolbelt."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["View imported job results."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"working-with-the-live-connect-api-postman-collection","__idx":2},"children":["Working with the Live Connect API Postman Collection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/treasure-data/TD-API-Documentation-postman-collections/blob/main/live-connect/README.md"},"children":["Live Connect API"]}," Postman collection is available to exercise the Live Connect APIs. To work with this collection you will need to perform the following steps:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable the Live Connect feature on your Treasure account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtained a Master API key for your account to authenticate the APIs"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtain an authentication ID of the authentication you want TD to use to connect to your datawarehouse"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/treasure-data/TD-API-Documentation-postman-collections/blob/main/live-connect/LiveConnectAPI.postman_collection.json"},"children":["LiveConnectAPI.postman_collection.json"]}," file"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/treasure-data/TD-API-Documentation-postman-collections/blob/main/README.md#configuring-td-collections-in-postman"},"children":["Configure the TD Collection for Postman"]}," where you specify the current values for {{baseUrl}} and {{ApiKeyAuth}}"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Specify the current value for {{tdAuthenticationId}}, which is the ID of the authentication you are using"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send one of these two calls to obtain an easy sync ID (or \"config ID\") to set as the current value for the {{dwhId}} variable:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a new DWH Integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["List all DWH Integrations for the current user"]}]}]}]}]},"headings":[{"value":"Quickstart","id":"quickstart","depth":1},{"value":"Overview of the Easy Sync Use Case for Snowflake","id":"overview-of-the-easy-sync-use-case-for-snowflake","depth":2},{"value":"Working with the Live Connect API Postman Collection","id":"working-with-the-live-connect-api-postman-collection","depth":2}],"frontmatter":{"seo":{"title":"Quickstart"}},"lastModified":"2026-06-01T09:09:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/dwh-integration-api/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}