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.
Data Enrichment for Native Sales Platforms
Add missing fields to Shopify, WooCommerce, or BigCommerce data pulled in through Triple Whale's native integrations.
Data Enrichment for Pixel Attribution
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, subscriptions, or customer profiles	Custom Sales Platform
Upload ad spend or survey responses	Custom 3rd-Party Integrations
Fill in missing costs, tags, or shipping data	Data Enrichment for Native Sales Platforms
Track offline events like leads or demos	Data Enrichment for Pixel Attribution

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, Product ID, 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.

Customers

Use Case: Upload customer profiles (identities, contact info, addresses, tags, consent status, order metadata) from platforms without a native Triple Whale sales platform.
Example Workflow:
1. Identify customers from your external platform or CRM.
2. Send a POST request with Customer ID, Contact Details, Address, Tags, Consent Data, and optional metadata like Amount Spent or Number of Orders.
3. Customer profiles become available for attribution, cohorting, segmentation, and downstream metric calculations.

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.

Data Enrichment for Native Sales Platforms

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.

Data Enrichment for Pixel Attribution

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.