Data-In API Use Cases

Triple Whale's Data-In API lets you bring in additional data or enrich existing records to give your business a more complete view of performance. It supports four core use cases:

• Custom Sales Platform
  Send source-of-truth backend data when using a sales platform that isn't natively supported.

• Custom 3rd-Party Integrations
  Bring in data from marketing, survey, or analytics platforms that aren’t natively supported.

• Native Sales Platform Data Enrichment
  Add missing fields to Shopify, WooCommerce, or BigCommerce data pulled in through Triple Whale's native integrations.

• Pixel Attribution Data Enrichment
  Send offline or server-side events (e.g. leads, demo bookings) that happen outside of standard Pixel tracking.

To see which platforms are supported natively, visit the Integrations page.

👍

Complement Native Integrations

Use Data-In API endpoints to extend Triple Whale’s capabilities, by uploading data from unsupported platforms or enriching records from native integrations. You can use them on their own or alongside other integrations for a more complete picture.

📘

Processing Times

• Data from the past 2 days should appear in about 5 minutes.
• Older data may take up to 20 minutes to process.

---

How to Decide

If You Want To...	Use This Category
Upload backend orders, products, or subscriptions	Custom Sales Platform
Upload ad spend or survey responses	Custom 3rd-Party Integrations
Fill in missing costs, tags, or shipping data	Native Sales Platform Data Enrichment
Track offline events like leads or demos	Pixel Attribution Data Enrichment

---

Custom Sales Platform

Orders

• Use Case: Upload orders (customer details, items, totals) from platforms without a native Triple Whale sales platform.
• Example Workflow:
  1. Identify orders to add from external platforms.
  2. Send a POST request with Order ID, Customer Details, Line Items, and Transaction Totals.
  3. Metrics like Order Revenue and AOV update automatically.

Products

• Use Case: Upload product data (details, variants) from platforms without a native Triple Whale sales platform.
• Example Workflow:
  1. Gather product details to upload.
  2. Send a POST request with Product ID, Product Title, Tags, and Variants.
  3. Analyze product performance trends.

Subscriptions

• Use Case: Upload subscription data (billing schedules, customers) from platforms without a native Triple Whale sales platform.
• Example Workflow:
  1. Collect subscription records to upload.
  2. Send a POST request with Subscription ID, Customer Details, and Subscription Items.
  3. Track metrics like New Subscribers and Churn.

---

Custom 3rd-Party Integrations

Ads

• Use Case: Upload ad data (spend, clicks, impressions) from ad platforms without a native Triple Whale integration.
• Example Workflow:
  1. Identify ad campaigns missing performance data.
  2. Send a POST request with Channel Name, Campaign ID, and Spend Amount.
  3. View updated metrics like ROAS and CPA.

📘

Import via Google Sheets

You can also use a Google Sheets wrapper to manually upload ads data—ideal if you prefer a spreadsheet interface or don’t want to manage API calls directly.

Post-Purchase Survey (PPS)

• Use Case: Upload survey responses from platforms without a native Triple Whale integration.
• Example Workflow:
  1. Collect survey data linked to orders.
  2. Send a POST request with Order ID, Survey Question, and Customer Response.
  3. Link survey insights to order metrics.

---

Native Sales Platform Data Enrichment

Use these endpoints to enhance records from sales platforms that already integrate natively with Triple Whale (e.g. Shopify, WooCommerce, BigCommerce):

🚧

Note

These endpoints are not supported for Custom Sales Platforms; to update custom orders data, resend the full order via the Orders endpoint.

Enrich Orders

• Use Case: Add fields like shipping costs or custom tags to existing orders from platforms with a native Triple Whale sales platform (e.g. Shopify, BigCommerce, WooCommerce, Stripe).
• Example Workflow:
  1. Find orders missing shipping cost data.
  2. Send a POST request with Shop, Order ID, and Shipping Costs.
  3. View updated metrics like Net Profit and POAS.

Enrich Products

• Use Case: Add cost data from external systems to existing products from Shopify (currently not supported for Products from WooCommerce or BigCommerce).
• Example Workflow:
  1. Find products or variants missing cost data.
  2. Send a POST request with Shop, Product ID, and Variant Costs.
  3. View updated metrics like Gross Profit and Contribution Margin.

Pixel Attribution Data Enrichment

Use this endpoint to send attribution-relevant events that occur outside the website session (e.g. demo bookings, sales calls, lead form submissions).

Enrich Pixel With Offline Events

• Use Case: Upload offline or server-side Pixel events (like leads, MQLs, SQLs, opportunities, book-a-demo events, or custom events).
• Example Workflow:
  1. Capture lead generation or demo request events occurring outside standard web tracking.
  2. Send a POST request with Shop Domain, Event Type (e.g., lead, mql, sql, opportunity, book_demo, or a custom event), and Profile Identifiers.
  3. Attribute these events to customer profiles and enhance lifecycle marketing analysis

---

Best Practices

• Check native support first: Before using the API, confirm whether your platform is already integrated: See integrations
• Choose the right endpoint: Pick from the four categories above to match your use case.
• Follow the schema: Match field requirements carefully to avoid errors and delays.
• Use enrichment for native platforms only: Enrichment endpoints are intended for enhancing Shopify/BigCommerce/WooCommerce data—not Custom Sales Platform setups.